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P5871 

MODELING STATES AND/OR TRANSITIONS IN A COMPUTER SYSTEM 

The present invention relates to the modeling of a computer system, e.g. a networked 
computer system. 

In published patent application WO/0 1 843 1 3 (and/or corresponding US 2002/0007468 A 1 ), 
the applicant company has proposed a system and method for achieving high availability in 
a networked computer system. It has also proposed a system and method for using high- 
availability-aware components to achieve high availability in a networked computer system. 

It has now been found of interest to model the platform and/or the applications which run 
on it, totally or partially. This invention offers various aspects of such a modeling, which* is 
applicable independently of the high availability aspects. This invention also offers 
applications of such a modeling, optionally, as it will be seen hereinafter. 

Generally, in one of its aspects, this invention offers a program product, comprising : , ; 

* groups of data, in a common software language, each group of data comprising : 

- first data modeling components (software and/or hardware), and interactions between such 
components (e.g. interfaces), 

- second data modeling a software load, comprising a set of components and a set of 
interactions, as defined in said first data, and 

* first software code capable of interacting with the first and second data, for qualifying said 
second data as defining a valid combination of components. 

The first data may include "version" data for the interaction data, and "version range" data 
related to component data, with the first software code checking that the version of an 
interaction lies within the version range of both components (e.g. a client and a server) 
cooperating through that interaction. - - 

In another aspect, said group of data may comprise generic entities for the components, 
interactions and software load; the generic entities have predefined members; and the first 
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and second data using such generic entities for representing the components, interactions and 
software load. 

In still another aspect, the group of data (or a relevant portion of it) may be stored in 
accordance with a common tree structure. Third data may be provided for modeling 
configuration values for loading a software load as defined in the second data. 

In still another aspect, fourth data may comprise platform update data for designating a 
configuration update, having has an update level, and the program product further comprises 
third software code capable of determining whether a transition to such a configuration ' 
update is authorized. A rollback may also be provided for. 

All the data may be based on a common software language, which may be a markup 
language, e.g. XML. 

Other alternative features and advantages of the invention will appear in the detailed 
description below and in the appended drawings, in which : 

- Figure 1 is a tree diagram depicting an exemplary physical component hierarchy among 
hardware components in a networked computer system; 

- Figure 2 is a tree diagram depicting an exemplary software component hierarchy among 
software components in a networked computer system; 

- Figure 3 is a representational diagram of an exemplary component that may be used in an 
embodiment of the present invention; 

- Figure 4 is a representational diagram of one embodiment of distributed system services 
that may be used in an embodiment of the present invention; 

- Figure 5 illustratively shows software components, forming client/server combinations; 

- Figure 6 shows an exemplary organization of model data, in an embodiment of this 
invention; 

- Figure 7 is a flow-chart of an exemplary version attribute checking tool; 

- Figure 8 shows an exemplary naming tree; 

- Figure 9 is a block diagram of an embodiment of this invention, at the design level; 
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- Figure 10 is a block diagram of an embodiment of this invention, at the operational level; 

- Figure 1 1 is a flow chart of an exemplary tool for checking the accuracy of version value 
intervals; 

- Figure 12 is a flow chart of an exemplary tool for checking version consistency; 

- Figure 13 is a flow chart of an exemplary tool for checking a configuration update; 

- Figure 14 is a "file-oriented"form of the flowchart of Figure 13; 

- Figure 1 5 is a flow chart of an exemplary platform update; 

- Figure 1 6 is a flow chart of an exemplary tool for checking the compatibility of an update 
set; 

- Figure 17 diagrammatically shows a "software load life cycle"; 

- Figure 18 is an exemplary block diagram showing how a given (hardware or software) 
component may interact with its surroundings, at the design level; 

- Figure 1 9 is an exemplary block diagram showing how a given (hardware or software) 
component may interact with its surroundings, at the runtime level; 

- Figure 20 is an exemplary flow chart showing how a component type configuration MIB , 
may be used when developing a component; 

- Figure 21 is an exemplary diagram showing a platform update operation; 

- Figure 22 is another exemplary diagram showing a platform update operation, in a different ■ 
view; - ""> - •'•**■' • 

- Figure 23 is an exemplary diagram showing the configuration of a component; 

- Figure 24 is an exemplary diagram showing a software update; 

- Figure 25 is an exemplary diagram showing a configuration update, made in response to 
a configuration update event; , : . *\ 

- Figure 26 is an exemplary diagram showing a component, and its interactions with its 
surroundings; and 

' ■■■■■ 

- Figure 27 is an exemplary diagram showing the operation of two redundant components, 
and their interactions with the surroundings. 

As they may be cited in this specification, Sun, Sun Microsystems, docs.sun.com, 
Answerbook, Answerbook2, Solaris, Java, EmbeddedJava, PersonalJava, JavaBeans, Java 
Naming and Directory Interface, JDBC, Enterprise JavaBeans (EJB), Jini, Sun Spontaneous 
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Management, Java 2 Enterprise Edition (J2EE), JavaServer Pages (JSP) and I-planet are 
trademarks of Sun Microsystems, Inc. SPARC is a trademark of SPARC International, Inc. 

A portion of the disclosure of this patent document contains material which may be subject 
to copyright protection. The copyright owner has no objection to the facsimile reproduction 
by anyone of the patent document or the patent disclosure, as it appears in the Patent and 
Trademark Office patent file or records, but otherwise reserves all copyright and/or author's 
rights whatsoever. 

Additionally, the detailed description is supplemented with the following Exhibits: 

- Exhibit Ehl contains an exemplary Document Type Definition or DTD in XML ; 

- Exhibit Eh2 comprises explanations on XML, and tables summarizing elements of the 
DTD of Exhibit Ehl; 

- Exhibit Eh3 is a description of the elements in the exemplary DTD of Exhibit Ehl ; 

- Exhibit Eh4 shows exemplary CGHA-ML code or "CGHA-ML definitions"; 

- Exhibit Eh5 comprises tables for use in connection with Exhibit Eh4; 

- Exhibit Eh6 shows exemplary tables of mapping from CGHA-ML; 

- Exhibit Eh7 shows exemplary LDAP configuration objects; 

- Exhibit Eh8 contains illustrative tables; 

- Exhibit Eh9 contains an exemplary LDAP object, i.e. a component type configuration MIB. 

In the foregoing description, references to the Exhibits are may be made directly by the 
Exhibit or Exhibit section identifier: for example, Eh7-01 would refer to section Ol in 
Exhibit Eh7 (the prefix designating the Exhibit may be omitted if there is no ambiguity). The 
Exhibits are placed apart for the purpose of clarifying the detailed description, and of 
enabling easier reference. They nevertheless form an integral part of the description of the 
present invention. This applies to the drawings as well. 

Now, making reference to software entities imposes certain conventions in notation. For 
example, in the detailed description, Italics (or the quote sign ") may be used when deemed 
necessary for clarity. However, in code examples: 

- quote signs are used only when required in accordance with the rules of writing code, i.e. 
for string values. 
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- an expression framed with square brackets, e.g. [property=value]* is optional and may be 
repeated if followed by *; 

- a name followed with [] indicates an array. 

- Also, <version> may be used to designate a value for the entity named "version" (or 
version). 

The reader is assumed to be familiar with object oriented programming in general, more 
specifically with Java. Details may be found at http://docs.sunxom. and http://Java.sun.com 
and/or in the corresponding printed documentation, e.g. "The Java Language Specification", 
J. GOSLING, Bill JOY, Guy STEELE, Addison Wesley, 1996, ISBN 0-201-6345 1-1 . Other 
printed documentation is currently available at: 

http://wwwl .fatbrain.com/documentation/sun . 

The reader is also assumed to be familiar with the extended Markup Language (XML) 
specification, available from W3C at http://www.w3.org/TR . and/or from the booklet 
"XML Pocket Reference", Robert ECKSTEIN, O'REILLY, U.S. A, October 1 999. 

The reader is further assumed to be able to map from a model in UML to a programming 
language such as Java or C++, and to be familiar with client-server applications written in 
C. The Unified Modeling Language, or UML, is defined inter alia in Appendix D of the 
Common Information Model (CIM) specification, available on the web site of the 
Distributed Management Task Force (DMTF) 3 http://www.dtmf.orgA or in the corresponding 
printed documentation. 

The reader is again assumed to be familiar with LDAP (Lightweight Directory Access 
Protocol). A detailed description of LDAP may be found at 
www.operddap.org/devel/admin/ . and in the corresponding printed documentation. 

A number of concepts described in the above cited WO/0184313 may be of interest in 
understanding the context and principles of this invention. Accordingly, the descriptive 
portion of WO/0184313 and/or US 2002/0007468 Al is incorporated by reference in this 
application. Alternatively, reservation is made for the inclusion of their figures 1 through 11, 
together with their description [i.e. paragraphs [0037] through [0174] of US 2002/0007468 
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Al or the corresponding text in WO/0184313), as an additional attachment to this 
application. 

The above described system may be used in a variety of applications. One of these is High 
Availability Platforms (HA platforms), as used in real time non stop computer networks. In 
the field of telecommunications, the applicant company has such a project, named Carrier- 
Grade High Availability Software Platform (CGHA Software Platform). 

FIG.l, FIG.2, FIG.3 and FIG.4 here correspond to FIG.3, FIG.4, FIG.6 and FIG.9, 
respectively, in WO/01 84313, with the same drawing labels, and will be shortly described ' 
here as an exemplary computer platform. Further details may be found in WO/0184313 
and/or US 2002/0007468 Al. 

FIG. 1 is a tree diagram depicting an exemplary physical component hierarchy (or physical 
containment relationships) among hardware components in a networked computer system. 
A network element 300 includes shelves 301 and 302. The shelf 301 further includes non 
host system processors or NHSPs 303 and 307, host system processors or HSPs 305 and 
306, and a hot swap controller HSC 304. The components that comprise the shelf 301 may 
themselves contain additional components. For example, the HSC 304 includes fans 308 
and power supplies 309. 

FIG. 2 is a tree diagram illustrating exemplary non-physical containment relationships or 
software component hierarchy among software components in a networked computer 
system. A network element 400 includes a node-1 401 , node-2 402, and node-3 403. Each 
node may contain additional components. For example, the node-1 401 includes an 
operating system 404, Asynchronous Transfer Mode ("ATM") stack 405, ATM driver 406, 
ethernet driver 407, and management applications 408. 

Components may be viewed as a fundamental unit of encapsulation, deployment, and 
manageability. When new applications and devices are added to a networked computer 
system, they are typically added as new components. 
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To prevent service outages during normal operation, components may accept dynamic 
changes in their configuration. It is common for the configuration of network-based 
applications to change during normal operation. To prevent frequent outages due to these 
configuration changes, components may be held responsible for recognizing that their 
configuration has changed and taking this change into account by operating based on the 
new configuration. 

As shown in FIG. 3, a component 601 might contain physical devices and their drivers 
600A, applications 600B, diagnostic applications 600D, applications for conducting audits 
600C, and error analysis applications 600E. 

By providing standard class-interfaces through which components interact with management 
agents and other applications, components may allow developers greater freedom in 
structuring and implementing components. In FIG. 3, a component manager 601 may 
function as an interface to a management agent ("MA") 602 and a component role and 
instance manager ("GRIM") 603 . The component 600 may also interface with a component 
error correlator ("CEC") 605 and clients 604. 

If newly-supplied components fully support all of the interfaces associated with their class 
and/or sub-class, they would automatically be manageable within various management 
contexts. 

In an embodiment, distributed system services ("DSS") may be used — the DSS may include 
a collection of location-independent mechanisms that enable applications to interact with 
one another. The DSS may enable applications to interact < with one another without 
knowing where they are running, or where the other applications with which they are 
communicating are running. Using the DSS, all applications may see the same messaging, 
event, and configuration services, independently of which node they happen to be running 
on. In other words, the DSS may allow applications to communicate regardless of their 
relative locations. . 

Application services may also interact with their clients through the DSS, allowing them to 
migrate from one node to another without affecting their clients. The DSS may also 
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facilitate load-sharing and system expansion by allowing work to be distributed among 
multiple processor nodes. 

As an Example, FIG. 4 is a representational diagram of one preferred embodiment of DSS. 
In FIG. 4, a DSS 900 provides at least seven types of services and/or mechanisms — a cluster 
naming service ("CNS") 901, cluster event service ("CES") 902, cluster configuration 
repository ("CCR") 903, cluster replicated checkpoints ("CRC") 904, reliable remote 
procedure calls ("RRPC") 906, asynchronous messages ("AM") 905, and reliable transport 
907. 

The RRPC 906 may provide a mechanism for basic intra-cluster or intra-system communica- 
tions. Using this mechanism, for example, a client may issue a request to any server in the 
system without regard to their respective locations and await a response. The RRPC 906 
may be suitable for services that require positive acknowledgments for robustness, require 
distinct requests to be serialized, or offer an automatic retry in case of a server failure. 

The AM 905 may also provide a mechanism for basic intra-cluster or intra-system 
communications. The AM 905 may require responses and may be suited for services that 
require minimum latency and overhead, do not require explicit acknowledgment or 
serialization, or can operate properly despite occasional silent failures. 

The RRPC 906 and AM 905 may also send calls and/or messages from exactly one sender 
to exactly one receiver over a pre-arranged point-to-point communication channel. 

The CNS 901 may be used to provide a cluster-wide, highly available naming service. 
Servers may register communication handles (and other things) under well-known names 
in a hierarchically structured name space provided by the CNS 90 1 . Clients may look up the 
names for services they want, and obtain communication handles (or other objects to support 
the exchange of services). Handles for both the RRPC 906 and AM 905 may also be 
registered and obtained from the CNS 901. 

The CES 902 may automatically distribute events from a publisher to all processes in a 
cluster that have subscribed to that type of the event. Using the CES 902, a publisher may 
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not need to establish an explicit channel with all possible subscribers. Similarly, subscribers 
may not need to establish an explicit channel with a publisher. 

It has now been found of high interest to model such a platform and/or the applications 
which run on it, totally or partially. This invention offers various aspects of such a modeling, 
including a new, polyvalent, software language, which may not only be used for theoretical 
modeling as such, as other modeling languages do, but also is "operational 11 , i.e. may be 
accessed by software processing tools, like generators or compilers, other than user interface 
for edition of the model. Such an Operational Modeling Software Language is hereinafter 
generically noted in short "OMSL". 

In WO 01/44934, the applicant company has described the preparation of a software 
configuration, using an XML type programming language. In one of its aspects, the present 
patent specification now comes to propose a concept for at least partially modeling a 
platform and/or the application running on it. " At least partially modeling" indicates that the 
modeling may be restricted to what is required to maintain the platform in operation. 

Broadly, the OMSL language being proposed may provide a single description ofrthe 
interfaces, management information and deployment configuration for application software, 
system software and/or hardware. This description may also be used by middleware. 
"Middleware" here refers to various software codes (e.g. the so-called "glue code") existing 
between the operating system and the application software. 

Figure 5 illustratively shows seven software components COMP1 through COMP7, which 
are servers or clients (the version aspects of Figure 5 will be considered later). Server 
COMP2 provides interface II which is used by both clients COMP1 and COMP2. Server 
COMP6 provides both interface 12 which is used by client COMP7, and interface 1 1 , used 
by COMP 1 . Client COMP5 uses both interface 1 1 , provided by server COMP4, and interface 
12, provided by server COMP6. The case of a component being both client and server is a 
simple extension of the scheme. 

The model data may be organized as shown in figure 6, which will be described first, to help 
in understanding the description of the OMSL language. 
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The Interface model MOl comprises sets of interface data MOlx (e.g. files), representing 
interfaces like those of Figure 5. The component model M02 comprises sets of component 
data M02x, based on interface data MOlx. The software load model M03 comprises sets 
of software load data M03x, defining a given arrangement of components and of their 
interfaces in a platform. The configuration update model M04 comprises sets of 
configuration data M04x, which may be viewed as "settings" as required by the platform 
when a corresponding given arrangement of components is in operation. Finally, the 
platform update model M05 comprises sets of platform update data M05x, each of which 
defines possible evolutions of the platform, with reference to a "current load" M05CL 
(which may be viewed as separate from model M05, or included in it). 

As shown in Figure 6, up to five models may be supported. This is exemplary only, and the 
invention may apply as well where only some of these models would be used, and/or some 
are mixed together. 



In certain flowchart drawing boxes, the identifier of the relevant model is shown in the upper 
leftmost corner of the box. 



The OMSL language may be based on extended Markup Language (XML), or on a similar 
modeling language. 

Exhibit Eh 1 shows an exemplary document type definition (DTD). As known, the DTDs are 
one of the current possibilities offered by XML for defining the language rules, and many 
tools exist to exploit them. However, alternative possibilities offered by XML, like XML 
schemas, may be used as well. Also, other language rule definitions may be used when using 
modeling languages other than XML, which may further be converted into XML, if desired. 
For example, UML may be converted into XML using XML 

When reading the DTD, attention should be paid to the word type, which may have different 
meanings: 

- the type e.g. of a constant, as usual in computer software, 

- an extended meaning, where type is associated with an identifier, and refers to the nature 
of the entity to be represented with that name. The type identifier itself is thus a name, but 
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that name further implies consequences as to the nature of the entity being named. In other 
words, a type defines some kind of specimen of an entity. Usually, a type identifier will 
have to follow certain rules, e.g. those related to versioning, to be described. 

The OMSL language defined by the DTD of Exhibit Ehl has been termed "CGHA Markup 
Language (CGHA-ML)", since it intends to serve in an HA or CGHA platform. Thus, with 
a view to facilitate understanding, reference may be made here to the system and to its 
constituents with the label or prefix "CGHA". It must be clearly understood, however, that 
"CGHA ,f or f, CGHA-ML M is used here as a convenient label, and that its use does not 
involve any intended limitation to a CGHA platform, and/or to telecommunication 
applications, and/or to the exemplary embodiment of CGHA-ML being described. 

Turning to the Document Type Definition or DTD shown in Exhibit Ehl, those skilled in 
the art will appreciate that such a DTD defines a set of tools for modeling various platforms, 
i.e. hardware and/or software systems. For those being not familiar with XML, Exhibit Eh2 
recalls the main concepts of XML, and has tables describing most elements of the DTD of 
Exhibit Ehl in natural language. 

Exhibit Eh3 describes the syntax and semantics of how to construct the above models when 
using e.g. the exemplary DTD of Exhibit Ehl . 

All of the above models may support versioning. In the example, the ve r s ion attribute 
is a positive integer. Other "incrementable" definitions may be used as well, with or without 
letters and/or separators. s 

When in use, versioning may be implemented e.g. as follows: a file defining an entity called 
<Entityname> may be named: <Entityname> ,xml, if the entity has no version, or 
<Entityname>.<version>.xml, if the entity is versioned, with <version> being e.g.l, 2, 3. 

In the exemplary Component Model, at least one ELEMENT has minVersion and 
maxVersion attributes. As shown in Table Eh2-1, the example shows in fact two such 



1 er depot 



12 

ELEMENTS : cgha.use, and cgha:provide, which may be used to offer two different 
functionalities: 

* the cgha : us e element (C2) may be used to declare the versions of an interface that are 
used by a component, considered as a client. 

* the cgha : provide element (C5) may be used to declare the versions of an interface 
that are provided through a SAP, by a component considered as a server. 

In each case: 

* minVersion specifies the oldest version of the interface that is used/provided, i.e. the 
version with the lowest version number. 

* maxVersion specifies the most recent version of the interface that is used/provided, i.e. the 
version with the highest version number. The value of this attribute must be greater than or 
equal to the value of the minVersion attribute (for the same entity created from use or 
provide). 

It will be appreciated that a number of objects or ELEMENTS in the DTD admit a "version" 
attribute, which may be required or optional. This is summarized in Table Eh2-2. The fact 
that version is optional in certain case is an implementation choice, which may reflect the 
fact that certain ELEMENTS will rarely change. In fact all ELEMENTS might be versioned. 

In the exemplary embodiment, versioning is mandatory: 

- in the interface model, for interfaces and object references, and also for event and the 
publish aspects, if implemented, 

- in the other models, for the components, the platform update, configuration update and 
software load models. 

Each versioned "ELEMENT" may be used as an attribute in another ELEMENT, using the 
cgha: attribute. 

The flow-chart of figure 7 shows an example of how version attribute checking (4500) may 
be made, when creating an entity, e.g. by a dedicated tool which may be incorporated in an 
OMSL compiler. The entity derives from an ELEMENT generically noted cgha.xxx, where 
xxx may be one of the elements of the DTD. The type identifier or entity name is "entName" 
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(4502) Operation 4504 determines whether "entName" already exists, or not. This may use 
the naming tree to be described in connection with figure 8. 

In the case of a new name, if version is supported by cghaixxx (4510) and mandatory, i.e. 
"required" (4512), operation 4514 verifies that version 1 is created (starting at any integer 
version might also be allowed). If version is not supported, no version number is allowed 
(4518). If version is supported, but not required, anything is possible (4516). 

In the case of an existing name, if version is not supported by cgha:xxx (4520), it is not 
allowed (4528), like for 45 1 8. If it is allowed and required (4522), a last version is sought 
(4526), and the entName should be supplemented (4526) with a version indication 
incremented by 1 (or any version number representing a non existing version, preferably a 
higher version). Then, at least for certain entities, compatibility between version may be 
checked, optionally (4527). If version is supported, but not required, operation 4524 
determines whether a last version exists for entName ; if so, the required path of operations 
4526 and 4527 is taken, otherwise the "unversioned" operation 4528 applies. 

At 4527, checking compatibility between versions may be implemented, e.g. for the 
following CGHA-ML entities along the following exemplary rules: v 

* interface: 

Two versions of the same interface must not have an operation, an attribute or a 
constant with the same name and a different signature. The signature of an operation 
consists of the number and types of its arguments, its return type and its declared 
exceptions. The signature of an attribute or a constant is its type (plus its version, if 
implemented). Note that two attributes with the same name must have the same type. 
This may be verified by the OMSL compiler. 

* For a number of other entities whose versioning is optional (e.g. structure, enumeration), 
there may be no need to mandate any compatibility between two versions of such an entity. 

Whatever its internal operation is, a software entity or component is known of other software 
entities essentially by what it exchanges with them. This may be broadly termed its 
"interfaces" ; however, in practice, a difference is made between interfaces as such, 
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examples of which have been discussed with reference to Figure 5, and other software 
"beings", like the exceptions and events. 

First, by using such an OMSL, it is possible to define a collection of interfaces, attributes 
(in the target software platform, not XML attributes), structure members, parameters, objects 
or contexts. Each of these can be defined by a group of data having a type, like simple type 
or structure. Examples of such groups of data are: 

- a map, which is an unordered set of pairs (key, value), where the key is an arbitrary string 
and the value is of a base type. All values have the same base type in a given map. A map 
is specified by setting the map attribute to "yes". 

- an array, which is an ordered list of elements of the same base type, indexed by integers. 
An array is specified by setting the array attribute to " yes ". 

The interface model makes it possible to describe sophisticated parameters, as they exist in 
the interactions of components within a computer platform, and thus to define models of 
that platform. The models may be represented by OSML files, which are XML files in the 
example. Other representations may be used as well, e.g. the LDAP representation to be 
described. Thus, OMSL files (files in the OSML language) may be constructed by platform 
architects, and stored in a repository (hereinafter called OSML or XML repository). 

Except where versioning and update level applies, two different items should have different 
names (or identifiers). To facilitate this, the repository may be organized as a hierarchical 
tree, which reflects the structure of the OMSL package hierarchy, also in connection with 
the naming of OMSL packages, if desired. 

An exemplary organization of the OMSL Repository on a customer platform will now be 
described with reference to figure 8. (Note the OMSL is CGHA-ML in the drawings.) 

After a main "root" node NO, there are three sub-trees with their roots in Nl 0, N20 and N30. 
Then: 

- the subtree stemming from nexus N110 (com/sun) may be arranged with a sub-nexus 
Nl 1 00 (cgha) forming a path to contain predefined OMSL files describing types (interface 
model) and components (component model). It may be arranged with sub-nexus to 
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distinguish standard OSML Software Platform types (N1101) and internal system 
components (Nl 102 and Nl 103). This may be called the "system repository tree". 

- the tree stemming from root N120 (com/telco) contains customer-specific OMSL files 
describing the customer platform and applications ("telco" is used here as a generic name 
for a customer organization). Its nexus N1201, N1202 and N1203 may follow an 
organization similar to those of the system repository tree (Nl 101, Nl 102 and Nl 103). 
However, other organizations may be chosen as well. For example, the customer-specific 
portion of the repository could be named jr/telco, or it could be located elsewhere in the file 
system. 

- the tree with root N20 (updates in the example) may contain OMSL files describing 
successive platform updates of the customer application. These files follow the software load 
model, the configuration update model or the platform update model. 

- finally, root N30 (cghamldtd) contains the unmodifiable file or files which define the 
OMSL syntax, e.g. the Document Type Definition or DTD. 

In the exemplary system Repository tree (com/sun sub-tree), only final directories, e.g. 
Nl 1 01 , contain actual OMSL files (leaves of the tree). The directory Nl 1 0 contains standard 
types and system components: 

* directory N1101 contains common interfaces and standard types used in the Software 
Platform. These "leaf 1 files follow the OMSL interface model. Subdirectories of Nl 101 may 
be used to receive files describing types specific to system components, for example ccm 
(Nl 1031), cec (Nl 1032), and crim (Nl 1033). 

* directory N1102 contains files defining hardware components. All files related to a 
hardware component may be located in a subdirectory, which contains the definition of the 
component as well as optional, specific component types and interfaces. For- example, the 
following hardware component subdirectories may be defined: netratl (N11021), 
networkelement (Nl 1022), shelf(Nl 1023). 

* The platform software Nl 1 03 directory contains files defining system components of the 
Software Platform. All files related to a system component may be located in a correspon- 
ding subdirectory. This subdirectory contains a file defining the component (component 
model). It may also contain files defining types and interfaces specific to the component, 
using the interface type model. For example, the following system components may be 
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defined: bootserver, ccm, cec, ces, cet, chm, els, emm, crcs, crim, csum, ma, oscm, slim, 
sltm. 

Turning now to Figure 9, a repository 2010 contains the model files, which may comprise 
the DTD 2011, predefined files 2012, and custom files 2013. The custom files may be 
prepared using an XML editor 2020, with a user interface 202 1 , e.g. the "XML mode" of the 
GNU "emacs" editor of the GNU. 

The rest of figure 9, i.e. the frame in dashed line 2030, may be called OMSL compiler, or, 
in short, compiler. It may include XML language editing tools, which may use a catalog file, 
e.g. an XML parser 2031, with a semantic analyzer 2032 (and, optionally, a syntactic 
analyzer, not shown). Then, one or more generators 2034 may be used to build files 2035 
in other languages and/or formats. Three different languages lang.l, lang.2 and lang.3 are 
shown, by way of illustration only. In practice, the languages may range from Java and " 
C/RPC to LDAP, HTML, while using corresponding mappings as necessary. Generators 
2034 may also be used for other purposes, e.g. with the software load mapping. 

Reference is now made to figure 10, which shows a system embodying several other 
inventive aspects. 

The repository 1510 may comprise various software packages (XML files and package files), 
amongst the following: platform update, configuration update, software load, applications, 
middleware, Operating system, hardware, and types. These may be checked at 2300,e.g. as 
described with reference to Figure 9. At 2320, software factory tools may be used to build: 

- component framework code 2340, which may comprise e.g. client stubs, service skeleton 
code, and management skeletons code, for example in C or C++; 

- one or more software load images 1 570, 

- LDAP data 2400, e.g. for use when the target system will internally need information about 
its own status and constitution, e.g. at runtime, and 

- a Management agent framework 2500, e.g. using Mbeans, and the applicant company's 
JDMK, i.e. java. 
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The models of Figure 6 will now be reviewed in more detail, with reference to the 
corresponding sections of the exemplary CGHA-ML in Exhibit Eh3, and to the example of 
Figure 8. 

The interface model MOl (Eh3.2) basically describes interfaces, and may also involve e.g. 
events, and/or exceptions. A given set of modeled interfaces will comprise the the interfaces 
that may exist in (be provided or used by) components of the platform, or a given part of it. 
Each interface defines the services that will be provided by, or supplied to, a component 
(subject to the capability of the component to have that interface). 

The interface model MOl (used e.g. in Nl 101) may basically support the specification of 
Interfaces. It may also support Events. 

In the embodiment, other auxiliary entities are also put in the interface model MOl : 
Exceptions, Structures, Object references, References, Enumerations. 

Certain items of MO 1 may have attributes, e.g. configuration attributes, for which the given 
set of modeled interfaces may define default values. 

Typically, a file might contain one interface, together with the related exceptions and the * 
structures necessary to define this interface. They may be grouped semantically, so that, for 
example, everything related to one call mechanism will be grouped in one file. However, 
various interface items may be mixed in the same file. 

< . 

The interface model MOl comprises the same level of functionality as CORBA IDLor Java 
RMI, with support for inheritance and exceptions. It has new features to cope with 
versioning, synchronous/asynchronous mode of communication and configuration. 

Now, the component model M02 (Eh3.3) represents components, using the above 
mentioned interface items. A component may be represented by a "component type", 
together with the interfaces it provides and the interfaces it uses. 
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The representation of components may use a tree structure, e.g. a hierarchical naming tree 
where each leaf is an object that implements an interface type. Furthermore, one may 
associate an object with each node of the naming tree. This is termed a Management 
Information Base, or MIB. 

A dedicated MIB may handle the configuration associated with the component type (e.g. a 
network element or cluster). A MIB is associated to its container, which may be e.g. a SAP 
{Service Access Point), a component type, or a cluster. In the MIB, it is possible to override 
the default value of the configuration, coming from the interface model. 

SAPs are used to specify particular aspects of a component, for example management, high 
availability or service. Each SAP provides a set of interfaces and an optional MIB. 

A given set M02x of modeled components may have the form of component model files, 
which may be located in the directories stemming from Nl 1 02, Nl 103, N1202, N1203. In 
a simple embodiment, an XML file may contain only one component. 

In more general terms, the component model defines component types which may be used 
on a cluster (whether hardware or software). In the case of software, component instances 
define the component types which are presently available; component assignments define 
if and how the component instances are assigned roles dynamically in the Software Platform 
(this may be also applied to controllable aspects of hardware). 

In the example, the versioning follows simple basic rules: 

* a given entity myEntity created from use (client) or provide (server) must have two version 
values for its minVersion and maxVersion attributes, respectively ; 

* it is not entitled to offer an interface (or other versioned item) whose version value is 
denoted <version> unless two conditions are met: 

- <version> is equal to or greater than the minVersion value of myEntity 

- <version> is equal to or lower than the maxVersion value of myEntity 

If desired, the accuracy of the [minVersion, maxVersion] intervals of the use and provide 
OMSL elements may be checked, e.g. as shown in the flow chart of figure 1 1. For each 
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component Ci in the component model (5010), operation 5012 gets the interfaces used by 
Ci, and, for each such interface gets the [minVersion, max Version] interval WUi for use. 
Operation 5014 checks that the Interface model indeed has an interface for each version 
within interval WuL Operation 5018 indicates that the same is done with [minVersion, 
maxVersion] interval WPi for provide. 

Other mechanisms may be constructed, using the version, on the one hand, and the 
[minVersion, maxVersion] interval, on another hand, based on similar principles. 

The software load model M03 (Eh3.4) specifies the software loads that are deployed on a 
given portion of the software platform, for example a Network Element, hereinafter termed 
a cluster by way of simplification. A software load represents a set of components (software 
and hardware). Along the exemplary embodiment, multiple versions of the same component 
are not allowed in a given software load (this would induce a more complicated processing). 

In a given software load: 

* Each component is represented by: 

- its definition in the OMSL model, in the example a component type configuration MIB, 
an instance MIB, and ah assignment MIB, Vi • 

- a list of software packages, and 

- a descriptor of its target localization. 

* The configuration associated with the Network Element or cluster (hosting the 
components) is handled through a dedicated MIB, called cluster configuration MIB. 

The flow chart of figure 12 shows how version consistency may be checked, e.g. within a 
given software load M03x. Starting from a list of coexisting components (5000) in the 
software load M03x, the component model is used (5002) to build groups each of which 
may be viewed as a client component Ci using Interface Ik provided by a server component 
Cj. Operation 5004 gets the [minVersion, maxVersion] interval Wi of Ci for Ik as "use", 
and the [minVersion, maxVersion] interval Wj of Cj for Ik as "provide". The components 
can cooperate if the intersection of Wi and Wj is not nil, as checked by operation 5008. 
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A software load defines ingredients of a software platform. A given condition of the settings 
in a software platform is termed a "configuration". The interface model MOl and the 
component model M02 define two levels of default configuration settings. However, further 
settings may be made at the time the software load occurs. 

Thus, the configuration update model M04 (Eh3.5) defines the configuration of a given 
software load ("configuration load"), and any modifications being made to that configura- 
tion. When initially loaded, a configuration is initialized, and then it may be updated. 

Each configuration load may be seen as applying to a specific software load. A given 
configuration load specifies the configuration of all the components of the software load it 
aims at. Configuration values are applied in terms of type, instance and assignment, and also 
the configuration of the Network Element, including deployment descriptors, redundancy 
schema and component relationships (to the extent applicable). 

The configuration load section of the configuration update model allows the initialization 
of a n-uplet of items, which, in the example, is a quadruplet : a cluster configuration, a 
component type configuration, a component instance configuration and a component 
assignment configuration. This implies that each component instance and component 
assignment should be named in a unique fashion, in the above described naming tree. 

The Configuration update model basically gives values to variables (in the broadest meaning 
of the word variable) ; this has the form Vi = Xi ,for a gi ven version, as shown in operation 
5030 of Figure 13. The Software load model is then accessed to know the component Ci 
being concerned by variable Vi (5032). The component model in turn indicates which MIB 
is concerned, and hence, which interface Ii is concerned (5034). And the interface model 
indicates the type of variable Vi (5036). An error is generated (5038) if any of the above 
level failed. A different error is generated (5040) if Variable Vi was found final in any of 
these levels (except 5030). Finally, Vi = Xi is accepted if the type of Vi, as found in the 
interface model, matches the type of Xi, as defined at 5030. 



Figure 14 is a "file-oriented"form of the flowchart of Figure 13. 
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The platform update model M05 (Eh3.6) provides the specification of a platform update, 
A platform update may be processed by the software factory tools as shown in Figure 15. 
It may comprise (5050) a "current load", which corresponds to the software load that is 
currently deployed on the Network Element, and its associated configuration. It may also 
comprise a list of configuration updates (from zero to N in number), and, optionally, a new 
software load, if any, that may be loaded on the Network Element in substitution of the 
current load and the associated configuration. 

The simplest role of the platform update model M05 is to change the configuration. First, 
all files involved in the update (and including configuration statements, in the form Vi = Xi) 
are compared (5052) with the corresponding files in the current load. If they are compatible 
(5054, to be developed), the generation of a new current load is allowed (5056). The new 
current load may be obtained by simply applying the configuration values being modified, 
as they were found at operation 5052. The other configuration values are kept. Then, updated 
configuration data are generated (5058). 

Figure 1 6 shows an exemplary way of checking the compatibility of an update set M05x at 
operation 5054. Operation 50541 builds the list of MIBs (MIBk) being involved in the 
update (the current load is assumed to have been checked previously in a similar fashion, 
and to be correct). Operation 50543 accesses the files comprising those MIBs and the 
corresponding components. Operation 50545 builds the list of all variables to be configured 
for these. Operation 50547 checks that all these variables are effectively given configuration 
values in the intended update (or in the current load). 

Thus, a Platform Update Model may provide support: y ' 

* for controlled and deterministic configuration updates to the current software load running 
on the Network Element. 

* for upgrading the software running on theNetwork Element from one release to a different 
release. 

In other words, the Platform Update Model defines the Software Load and the Configuration 
Updates that are applied on a Network Element. In a configuration quadruplet (cluster, type, 
instance and assignment), each entity may have an associated update level Thus, 
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modification of the configuration is made possible without having to build a new Software 
Load. 

The Software Factory tools 2030 may be used for managing this notion of update level. The 
update level is incremented (or otherwise differentiated) after the update has been checked 
and authorized. The resulting configuration information may thereafter be provided to each 
running component instance being "re-configured". 

Let entity be an item in the above mentioned quadruplet : cluster configuration, component 
type configuration, component instance configuration and component assignment 
configuration.. The configuration of such an item of a component is defined by: 

- its name <entityName> 

- its version, e.g. 2, and 

- its update level, e.g. 3. 

The version is known at compilation time. The name is defined when the component entity 
is created. Conversely, such an entity may be informed that its configuration has changed 
in an asynchronous fashion by an event, which may indicate the most recent update level. 
In response, the entity will change its configuration, e.g. by re-booting, which forces it to re- 
acquire its configuration data ; "softer" reconfiguration processes may also be applied, 
subject to adequately determining the status of the relevant portion of the platform. 

To check the consistency of a software load and/or a configuration update in respect of what 
has been deployed on a Network Element, and to generate the appropriate update levels, the 
Platform Update Model supports the definition of the current load. 

A current load defines the components that have been deployed on a Network Element, 
defining for each component its type, its version, its instances and its assignments with the 
associated update levels and configuration. For the cluster, the current load defines its 
version, its update level and its configuration. 

The Software Factory tools generate for each Platform Update the resulting state of the 
Network Element, using the cgha : currentLoad element. This resulting state should 
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be used as the current load in order to define the next platform update of the Network 
Element. 

Files containing a software load, a configuration update and/or a platform update may be 
located in an upda t e s subtree (N20). Each file should contain only one definition, named 
<definitionname>, which can be a software load, a platform update or a configuration 
update. 

Now, rules and guidelines may be established to govern how a platform and its components 
will be defined in the OMSL language. This concerns both the organization of the files and 
their actual content. The rules and guidelines may have the following aspects: 

- the organization of the repository 1520 and the rules to be enforced when naming the 
software and/or hardware entities. 

- the rules that must be followed when defining a component. 

Further rules that should be followed when defining a cluster may be added, to correctly 
feature the hardware, and its redundancy features. : \, 

OMSL models may be used as such, when conceiving an application (part or all of a ' 
system). They may also be mapped to programming languages, e.g. C or Java. This allows 
to link an application to other components and to the Software Platform, and/or to provide 
remote manageability of the platform. 

Tables Eh6-1, Eh6-2 and Eh6-3 in Exhibit Eh6 show examples of mappings to Java, 
C/RPC, and LDAP, respectively. Mapping from the OMSL to Java arid/or C/RPC may be 
considered similar to mapping from other modeling languages to Java and/or C/RPC, and 
therefore will not be described in further detail. By contrast, mapping to LDAP will be 
described in more detail hereinafter. 



It will now be appreciated that the OMSL language has following capabilities, which, of 
course, may be used only partially: 
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- establish a formalized description of a Software Platform ("information model"). In fact, 
the OMSL language may be used to model not only the applications that run on the HA 
Software Platform, but also the constituent entities of the platform itself (hardware, 
operating system and/or middleware). 

- use of various user-oriented tools, e.g. validation tools, when establishing that formalized 
description. 

- possibility to build a set of specifications and tools to assist developers with the design of 
components. 

- the formalized description in turn may be used by various "operational" tools, for example 
when developing components or when constructing software loads, and their configuration. 
This may go up to the deployment of the components and of the platform on which they run. 

The above defined models apply within what may be called a "software load life cycle". This 
concept will now be illustrated with reference to Figure 1 7. The notations used in figure 1 7, 
e.g. to the extent they refer to an XML embodiment of this invention, are purely exemplary. 
In the tree hierarchy, the top level is "platform update" (N20, figure 8), which comprises a 
software load and a configuration. 

Figure 1 7 shows: 

- a package repository 1500, which may store in any appropriate data format, e.g. a file 
system, the software code to be used in connection with a particular platform, both at the 
hardware level, e.g. drivers, and at the software level, e.g. application programs. Middleware 
may also be included, as desired. 

- an OMSL repository, e.g. an XML repository, 1520, which may store in any appropriate 
data format, e.g. a file system, sets of the model data to be used, in the OMSL language. 

Thus, a typical software load life cycle may involve: 

- the installation of one or more components 1530, 1531, 1532 , which may use both 
repositories 1500 and 1520; 

- the definition of a software load 1540; this may use model repository 1520 only; and 
produces a representation of the software load, e.g. a softwareLoad.version.xml file; 
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- the processing of the software load 1550 may involve a tool, named e.g. mttswload, which 
uses that representation, in connection with both repositories 1500 and 1520, to generate 
a corresponding list of packages 1552, named e.g. softwareLoad.version.pkgs. 

- the final software load build 1 600, which converts the set of packages into a SoftwareLoad 
image 1570. The SoftwareLoad image 1570 comprises data loadable in memory for 
operating a computer system, e.g. 1 590. This uses a Software Load Build Tool also denoted 
SLBT. 

Figure 17 is made in the form of interconnected blocks, for more clearly showing the 
interactions between its elements. It will be appreciated that it may also be viewed as a flow 
chart, having operations 1530 through 1570. The separation in a plurality of levels of 
operations is purely illustrative. For example, operations 1550 through 1570 might be 
considered as a single level of operations as well. 

The Component Definition Rules will now be considered. 

To begin with, Figure 1 8 shows how a given (hardware or software) component 2 1 00 is seen 
by its surroundings. It has a variety of component-to-component interfaces 121 Ox with other 
components 2 1 Ox. (the x reflects the fact the other components are plural). It also has a 
component-to-framework interface 12 1 20 with the framework 21 20. > 

The framework 2120 may comprises e.g. the following runtime tools : 

- the Component Role Instance Manager (CRIM) 2121, which defines the instances and 
assignments of components, 

- the Management Agent (MA) 2122, which may be used to manage software, 

- the Component Executor and Terminator (CET) 2123, in charge of having components 
being put in execution, or, on the contrary, terminated. 

Additionally, the component may be associated (L2130) with a component configuration 
element 2130. Also, the framework 2120 may be associated (L2140) with a cluster 
configuration element 2140. The interactions L2130 and L2140 may be separate for each 
element of the framework, as shown in dashed lines. 
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In an exemplary embodiment, the items marked by an [X] in figure 1 8 may be defined using 
the OMSL. 

Figure 1 8 is a "model view" of a component and its surroundings. As shown, it is centered 
on a given component; however, a similar view may be made centered on another 
component as well. 

At runtime, there corresponds to the model view of figure 18 a "runtime view", e.g. as 
shown in figure 19. Component 2100 and others components 21 Ox interact as shown at 
D2 1 Ox to execute their tasks. They have access to a database 2 1 50, containing configuration 
data ("configuration" is taken here in its broadest sense), via C2100 and C210x. The 
component 2100 being considered works under control of the framework 2120, e.g. the 
CRIM, MA and CET, as shown by links M2121, M2122, M2123. The elements of the 
framework 2120, e.g. the CRIM 2121, MA 2122 and CET 2123, may also access the data 
base 2150, as shown at C2121, C2122, C2123. 

In fact, the framework 2120 will play a similar role for the other components. This is not 
shown on figures 18 and 19, since they are centered on a given element 2100. 

Having thus defined how a component may be viewed, modeling a component in OMSL 
will now be considered. 

Modeling may comprise defining at least one mandatory MIBs {Management Information 
Base) at the Component Model level, together with a corresponding SAP. (It is reminded 
that a MIB may be attached to a SAP, which uses the MIB to deliver information 
corresponding to the SAP's "mission"). By so doing, the component having such MIB and 
SAP follows some sort of "contract" with other components and other surrounding 
functions. 

An exemplary set of MIBs and SAPs will now be described. 

The exemplary set of MIBs is set forth in Exhibit Eh4. The SAP names, object names and 
corresponding object types are summarized in tables Eh5-1, Eh5-2 and Eh5-3 of Exhibit 
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Eh5. It should be clear that these examples and the MIB/SAP names are illustrative, and 
should not restrict the scope of this invention. 

The example involves three mandatory MIBs/SAPs : 

* whether it is hardware or software, a component will have a component type configuration 
MIB, to give the framework access to the configuration data of the component. 

* a software component additionally has a component instance MIB, and a component 
assignment MIB. Roughly, the instance is how the software component exists ; assignment 
is the role it is currently playing. This distinction between instance and assignment (or role) 
is of interest in redundant systems. In other systems, a single MIB could be used for both 
instance and assignment. 

Generally, each of these MIBs comprises a well-defined collection of objects, as required 
for correct platform operation. The fact these MIBs are defined correctly may be checked 
by the user who models a component and/or by the compiler 2030. 

The objects in the MIBs may be used by the platform services (e.g. items of framework 
2120) to orchestrate platform behavior correctly. Concerning the names of the mandatory 
SAPs, of the mandatory objects defined by the MIBs, and the corresponding types of the 
mandatory objects, those should be predefined by the platform architect, and not be changed - 
thereafter. Now, there may be provided application-specific values to object attributes. 

The Component Type Configuration MIB is a collection of software objects which describe 
the configuration of a component type * 

■ r .■■ 

Predefined interfaces types may be defined. In the example : 

- a generic Component Descriptor interface, which has three attributes, as shown in 
table Eh5-4 in Exhibit Eh5. The OMSL description of the attributes of the 
Component Descriptor interface type may be as shown in Eh4-1 . 1 has two children: 

- a SoftwareComponentDe s crip tor , usedfor software components (Eh4-1 0); it has 
two additional attributes: creationDescriptor, deployment Descriptor., which 
may be used to describe the component type configuration as required by the CET. 
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- a HardwareComponentDescriptor , used for hardware components (Eh4-ll), 
which is empty, i.e. defines no additional attributes. 

One object must be included in the component type configuration MIB. It is a simple object 
with the name componentDescriptor. The componentDescriptor object 
implements one the above children of the Component De s cr ipt or interface, depending 
upon it is a hardware of software component The generic ComponentDescriptor 
interface type defines the component type configuration required by the framework services 
2120. 

For both hardware and software components, the componentDescriptor object 
describes component type configuration data, e.g. the component category and redundancy 
model required by the CRIM. It also describes component packaging. For a software 
component, it additionally describes configuration data, e.g. those needed by the CET to start , 
up and deploy a component. The user needs to define his own attribute values for the 
componentDescriptor object. 

Thus, the componentDescriptor object defined by the Component Type Configura-, 
tion MIB (Nl 1 01 1 ) gives the framework (2 1 20) access to values for the configuration object 
attributes. For example, some configuration data is needed by the CRIM, such as the 
availability model of the component. The MIB (Nl 101 1) may be extended to hold other 
objects specific to an application. 

Type configuration may be required for each component by the framework entities 
exploiting the OMSL language, as it will now be described. 

In the example, the Component Role and Assignment Manager (CRIM or 2 1 2 1 ) requires the 
following component type configuration: 

* a component category, defined by the componentCategory attribute (Eh4-2), 

* a redundancy model, defined by the availabilityDescriptor attribute (Eh4-3) 

* a switchover escalation (see Eh4-4), which consists of count and time window, and tells 
the CRIM that if the component has been restarted "count times" during the past "time 
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window" period (in seconds), and the component still experiences errors, then the 
unsuccessful restart recovery should be escalated to the node switchover. The switchover 
escalation count and switchover escalation time window are defined by the 
availabilityDescriptor attribute. 

* a time out (in seconds) for a component to respond to CRIM requests. This is defined by 
the availabilityDescriptor attribute. 

* a restartable attribute , a boolean indicating whether the associated component type is 
restartable and can be recovered from some types of errors by restarting. 

In the example, the component type configuration required by the CET (Component 
Executor and Terminator is provided by the creationDescriptor attribute, and 
specifies (Eh4-5): 

* The creation time out of the component. This is the time out value for the component to 
respond back with initialization completed after the CET has started up the component. 

* The binary path of the component, required to start up the component. 

* The termination time out of a component. This is the time out value for the CET to receive 
a component termination acknowledgment, after the CET has requested the component to . 
terminate. ; .. 

* The user id and the group id of the component. This is needed by the CET whenrstarting 
up the component. 

A Software Load Build Tool or SLBT may be used. The SLBT requires information 
regarding the component packages and the target platform and OS. A tool (identified as 
ml2swload, in the example) may provide this information for the SLBT, Using the 
following component type configuration as input (Eh4-6): 

* The packaging descriptor, which describes component packages. The platform, OS, and 
package type (documentation, runtime or development) are described for each package that 
has a package name. 

* The deployment descriptor, which describes the target platform and OS on which to 
deploy a component. 



The example in Eh4-20 shows how the component type configuration MIB may be used 
when developing a component. The predefined object name (e.g. componentDescriptor) and 



1er depot 



30 

its corresponding type should be respected ; its attribute values may be changed to be 
specific to a given application. 

This example will be described in more detail, with reference to the operations in the 
flowchart of Figure 20, and to the sub-sections in the code of example Eh4-20: 

- operation 4002 (Eh4-20A) imports the relevant package for the types (version 1) of a 
SoftwareComponent Descriptor, and then defines the name of the component type (here 
"SoftwareComponentExample"), its version, type and description. 

- in the MIB, operation 4004 (Eh4-20B) declares the object componentDescriptor, 
with its type as defined above. Then, one may initialize the desired attribute values for the 
component Descriptor object, setting the values according to the platform application 
to be represented by the MIB. 

- operation 4006 (Eh4-20C) initializes the component Category attribute. 

- operation 4008 (Eh4-20D) initializes the availabilityDescriptor attribute, a 
structure having various members. 

- operation 40010 (Eh4-20E) initializes the creationDescriptor attribute, another 
structure. 

- operation 400 12 (Eh4-20F) initializes the packagingDescriptor attribute, an array 
of structures, the contents of which will be understood bty those skilled in the art. 

- operation 40022 refers to the deploymentDescriptor attribute, another array of 
structures, which is initialized later, at the software load. 

The instanceManagement SAP gives remote clients access to the corresponding 
mandatory MIB associated with the component instance. This MIB consists of a collection 
of objects whose role is to provide necessary information associated with a component 
instance. One can extend the MIB with objects specific to a given application, while 
respecting the mandatory objects, as shown in example Eh4-21. 

A distinct assignmentManagement SAP may be used to give remote clients access 
to the component assignment MIB. This information may be used by the HA management 
services, such as the CRIM. One can extend the MIB with other objects specific to an 



1er depot 



31 

application. The interface type defines attributes related to the assignment management, for 
example, the usage state. 

The OMSL definition of that interface may be as shown in Eh4-30. There is one mandatory 
object in the component assignment MIR As the interface is a singleton, the object does not 
have a name. This object and its related type must be respected so that the platform can 
function correctly. The object may provide the usage state of a component, which may be 
idle, or, by contrast actively in use at a specific instant, and if so, whether it has {active) or 
not (busy) spare capacity for additional users at that instant. The usage state may be reported 
by the component itself. 

This state influences the decision-making aspect of platform behavior, and is required by the 
HA management services, in particular the CGHA availability services, so that a platform 
will run correctly. The component gives access to the usage state, which is that of its 
assignment. A component instance can have only one assignment during its primary role. 
An example of how to use the assignmentManagement SAP appears at Eh4-3 1 

To sum up, a configuration, when defined by an OMSL like CGHA-ML, may be organized 
as a set of MIBs, specified using the cgha : mib element. A MIB is a hierarchical tree of 
objects and contexts, defined using the cgha : obj ect and cgha : context elements. 
In fact, the OMSL language may be used to define three categories of MIB: 

* MIBs associated with a specific SAP. This category of MIB is contained within the 
cgha : sap element. SAP level MIBs are fully initialized during component instance 
definition or component assignment definition. Component instances and assignments are 
defined using the cgha : instanceConf iguration - element and the 
cgha: assignmentConf iguration element respectively. 

* MIBs associated with a specific component type configuration. This category of MIB is 
contained within the cgha: type element. Component type configuration MIBs are 
initialized during component load definition, using the cgha : componentLoad element, 
or during component type configuration, using the cgha : typeConf iguration 
element. 
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* A MIB associated with the cluster configuration. This MIB is contained within the 
cgha : cluster element. The cluster configuration MIB is initialized during cluster 
configuration, using the cgha : clusterConf igurat ion element. 

The Software Load Model is another aspect of this invention. 

The purpose of the Software Load Model is to define a set of components to deploy on a 
network element or cluster. This set of components is known as a software load. Thus, the 
output of the software load will be a list of packages (e.g. Solaris packages) defining the 
component part of this software load. The OS (e.g. Solaris) packages are contained in a 
repository and are therefore referred to by their name. 

The exemplary software load model defines three elements: 

* cgha : sof twareLoad, which is mapped to the package list file. The 
cgha : sof twareLoad element is the top element defining a software load and identifies 
the software load. 

* cgha : cluster, which is not mapped to the package list file. The cgha : cluster 
element is used to define the cluster on which the software load will be deployed. 

* cgha : componentLoad, which is mapped to the package list file. A 
cgha : componentLoad element defines a component which is part of the software load. 
The cgha : componentLoad element first generates comments lines in the package list 
file identifying the component to be added. For a specific component, if no package names 
can be found, or if only package names common to all platforms and OS are found, a 
warning message is displayed to the user. The package list is verified to ensure that each 
package appears once and only once. 

A standard ComponentDescriptor interface may be used for: 

* defining whether the package is specific to one platform and one OS, or common to every 
platform and every OS (intermediate situations may be covered). When writing the 
Component Model, the user specifies which package will be on which platform and OS. The 
targeted platform and OS are defined by their names (for example, spare and solans), or the 
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word "common" can be used to point to all platforms and/or OS. Different types of packages 
may be used, e.g. RUNTIME, DEVELOPMENT or DOCUMENTATION. 
* defining the platform and OS on which a component will be deployed (these are also 
known when writing the Software Load Model). This information may be stored in a 
ComponentDescriptor standard interface, using the initialization clause of the 
cgha : componentLoad element. 

When compiling the Software Load Model, the compiler will look for the 
ComponentDescriptor standard interface to retrieve information regarding the 
platform and the OS on which the Software Load will be deployed. With this information, 
package names will be found. Finally, only package names with RUNTIME type are 
retained. 



A s'of twareLoad Description file may be used to describe a software load in OMSL, in 
the following way: 

- It first shows the description element, then a list of imports needed to use components and 
interfaces already defined. . .-> 

- It then defines a cluster. Since this definition is not part of the OMSL to Software Load 
mapping, it is not considered here. 

- Finally, each component part of this software load is enumerated. 

- For some components, the platform and OS are initialized (for example the CRIM 
component). 

The Component Descriptor will now be considered. By looking at the Component Model 
for every component included in the software load previously defined, it is possible to see 
which package names will be output. For example: 

in a Boot Server Component, no package names are declared, the structure 
PackagingDescriptor is not initialized. No package names will appear in the 
package list. 
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* a CEC component defines package names for every platform and OS, but the platform and 
OS are not initialized in the software load. Thus, no package names appear in the package 
list. 

* there may be package names defined specifically for each platform and each OS, plus 
some package names that are common to every platform and OS. The software load does not 
initialize the platform and the OS, but the common package names are output. 

* turning to the CRIM Component, there may be package names defined specifically for 
each platform and each OS, plus some package names that are common to every platform 
and OS. In this example, the software load initializes platform and OS to Sparc and Solaris. 



The platform update model is now considered again. 

Reference is now made to figure 21, which shows how an OMSL language facilitates a 
platform update operation. In this example, a HA-cIuster HACx is considered. 

Before the update, cluster HACx is in a previous state st-ante, with a Current Load 1 
(denoted cl-ante), comprising software load image swlante , and configuration update cnf- 
ante. This is reflected in the currentLoad.1 .xml file or package in the OMSL language, e.g. 
CGHA-ML. 

The update itself is defined in the platformUpdate. 2. xml file or package. In the example, it 
comprises softwareLoad.2.xml and configurationUpdate.2.xml.. 

From these files, the status st-post after the update may be: 

- defined, by currentLoad.2.xml file or package in the OMSL language, and 

- prepared to have Current Load 2, denoted cl-post, comprising software load image 
swl^post , and configuration update cnf-post, which may be loaded into cluster HACx . 

As shown in figure 22, a platform update may be entirely defined from an XML package 
PLTFUPDT, stored inrepository 1520, generically named platformUpdate. <version>.xml, 
and comprising: 

- a currentLoad. <version>.xml (2820), 
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- a softwareLoad<version>.xml (2840), 

- one or more corifigurationUpdate.<version>.xmL(2860) 

Furthermore, the XML data may be used by a tool (denoted mllconfig in the example), to 
produce a platformUpdate. <version>. next. xml ("next" here means "next current") at 2840. 

The tree structure used with OMSL may be conveniently represented in a directory system 
like LDAP. Thus, Figure 22 additionally shows LDAP data, e.g.: 

* platformUpdate. <versiori>. populate, Idif at 2842 

* platformUpdate. <version>. apply. Idif at 2844 

* platformUpdate. <versiori>. rollback Idif at 2846 

* platformUpdate. <version>. remove. Idif at 2848 

The LDAP data may be stored at 2400 in figure 10, as another representation of theOSML 
tree, which may be readily accessed at runtime. The aspects of mapping from OMSL to a 
directory system like LDAP will be described hereinafter. For the time being, the parallel 
OMSL and LDAP trees are considered commonly as an "OMSL/LDAP tree". 

A platform update process may have different forms: ... P 

i) it may update just the configuration associated with a MIB. Such an update of the 
configuration alone is reflected by incrementing the update level of the MIB. 
Ii) it may update both the structure and the configuration associated with a MIB. An update 
of both structure and configuration is reflected by incrementing the version of the MIB 
container (cluster or component). , // 

' ••■ .y"/ 4 

It should be noted that the version and update level are also part of the OMSL/LDAP naming 
tree. 

If the MIB has been updated, then during the platform update process, there are simulta- 
neously two different MIB configurations, with two corresponding sub-trees - in 
OMSL/LDAP, respectively. One corresponds to the MIB configuration before starting the 
update process, (stjxnte in Figure 21) and the other corresponds to the MIB configuration 
after the update process (st _post in Figure 2 1 ). 
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The platform update table may be a part 28422 of item 2842 in figure 22, together with the 
LDAP MIBs 28420. 

To have access to its configuration, a component must know the update level corresponding 
to each MIB. When a component is running, the update level can change. A uniform 
mechanism is available to access MIB configuration at runtime, using the platform update 
table. This platform update table provides a mapping between a MIB container name and 
the associated configuration tree. The table contains the identifiers (e.g. LDAP Distinguis- 
hed Names or DNs) of all the MIBs that are defined. A new platform update table is 
generated for each new platform update. The platform update table is accessed indirectly by 
means of the version of the software load. Each software load contains the DN of the 
appropriate version of the platform update table. 

To summarize, the Platform Update mechanism is organized in the following way: 

* Each MIB is fully defined by its container (cluster, component type, SAP), the version of 
the cluster or the component type and its update level. 

* A platform update table, containing the identifiers (e.g. LDAP DNs) of all the MIBs 
defined, is provided for each platform update version. 

* The identifier (e.g. DN) of the appropriate platform update table is provided for each 
software load version. 

The OMSL/LDAP trees are used in Figures 23 through 27, in which the LDAP information 
is diagrammatically shown.. 

Figure 23 considers the configuration of a component, here a cluster CLS1, which has an 
instance "i" and an assignment interface "a". In figure 23: 

- a component type configuration MIB 3000 reflects the type of the component in the OMSL 
(e.g. CGHA-ML), and is mapped into a corresponding LDAP sub-tree "CLS1,1". 

- a component instance MIB 3002 has access to the MIB 3000 (as defining the LDAP sub- 
tree CLS1,1 which corresponds to the "internal" type of the component). It defines the 
"instance" of the component using a "SAP name". This is reflected both internally in the 
component at 3012, which is shown as an interface, and is mapped in a corresponding LDAP 
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sub-tree "cls,instancel , 1 ". Other components, and management functions, may thus be aware 
of what component CLS1 can do. 

- a component assignment MIB 3004 has access to the MIB 3002 (as defining what the 
component can do). It defines the "assignment" of the component using a "SAP name". This 
is reflected both internally in the component at 3014, which is shown as another interface, 
and is mapped in a corresponding LDAP sub-tree "cls,assignmentl,l ". Other components, 
and management functions, may thus be aware of what component CLS1 actually does. 

Thus, a software update may take place as shown in Figure 24 (The MIBs are not shown, for 
more clarity in the drawing). New "values" (in fact complete sets of data), suffixed 2,1 have 
been loaded in the repositories and mapped to LDAP. The component CLS1 initially 
working under "1,1" is rebooted, and then works as "2,1". (In fact, as shown, this may also 
occur when only a node of the cluster is rebooted). Of course, the new values "2, 1 " need not 
be entirely different from the old ones " 1 ,1 ". In certain cases, they may even remain identical 
(reboot without change). 

Figure 25 shows a configuration update, made in response to a configuration update event # 
(for example a "sleeping" node should be substituted to a failing node) . The situation is 

similar to that of Figure 24, except that there is no reboot, and the "cls,instance l,l":and the 

,-•■••/ 

corresponding instance MIB (not shown) is not modified. : : ; 

Figure 26 shows again the component CLS1 of Figure 23, with its interfaces 3012 (instance) 
and 3014 (assignment), now under control of management functions 3022 and 3024. 
Interface 3016 "exposes" the services offered by the component to other components. 
Interface 3018 enables the "callback" , used e.g. for connection with the platform services. 

Redundancy may be managed as illustrated in Figure 27. Two "equivalent" components 
CLS1A and CLS IB are shown, with the same interfaces as in Figure 26, suffixed with "A" 
or n B". LDAP data 3400 have distinct sub-trees for the instances 3012A and 3012B, 
however the same sub-tree for the assignments 301 4A and 301 4B. 

A management agent 3500 accesses interfaces 3012A, 3012 B and 3014A, and builds e.g. 
corresponding Mbeans, assuming the applicant company's JDMK is being used. 
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Thus, by having the management agent 3500 accessing the LDAP data, the software 
management may be conducted with knowledge of what the component CLS1A in service 
can do, and actually does, and of what the "sleeping" component CLS1B can do. The 
management agent 3500, e.g. via the Mbeans, controls the management interfaces 301 2A, 
3012 B and 3014A accordingly. 



on 



While the OMSL language may form a basis for organizing named objects and configurati 
data, a directory system may be conveniently used to make such objects and data available 
at runtime. This has been shown in figures 22 through 27, with the directory system being 
an LDAP directory server in these examples. 

This may make use of a mapping from an OMSL to a directory system like LDAP 
(Lightweight Directory Access Protocol). Such a mapping is now considered. The language 
being used on the directory system side is hereinafter generically termed Directory System 
Software Language, or, in short, DSSL. 

In this OMSL-to-DSSL mapping section of this specification , reference will be made to 
LDAP examples as follows: 

- Exhibit Eh7 shows exemplary LDAP configuration objects, 

- Exhibit Eh8 contains illustrative tables, 

- Exhibit Eh9 contains an exemplary LDAP object, i.e. a component type configuration 
MIB. 

In the examples, the directory system is based on LDAP, and the DSSL uses the LDAP Data 
Interchange Format (LDIF) syntax. The LDIF format is a standard way of representing 
directory data in a textual format. However, the LDIF format is exemplary only, and other 
DSSL notations may be used as well. 

The diagram Eh7-0 in Exhibit Eh7 shows an exemplary LDAP layout. A corresponding 
LDAP Schema may adopt the overall organization reflected in the LDAP layout being 
shown. In accordance with another aspect of this invention, at least some of the layout items 
have a "version" qualifier or entry. In the example, every layout item has a "version- 
qualifier or entry. 
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In accordance with still another aspect of this invention, at least some of the layout items 
have an "update level" qualifier or entry. In the example, an "update level" is defined for the 
cluster, types, instances and assignments. 

It should also be kept in mind that the LDIF format is "reversed" with respect to the 
"directory-like" description of a tree structure. For example: 

* the LDIF notation leaf_node, nexus2, nexus 1 , root 
corresponds to 

* the directory-like notation root\nexusl\nexus2\leaf_node 

Accordingly, when converting the exemplary LDAP layout (shown in the diagram Eh7-0 in 
Exhibit Eh7) into in a corresponding tree structure, the respective levels of "update level" 
and "version" are reversed. 

In other words, applying this e.g. to the examples in the diagram Eh7-0 would result into: 

mib\update level\version\<referenced object>, 
where Referenced object> may be: 

- cluster 

- component type\type j* 

- sap\component instance\instance , 

- sap\component assignment\assignment 

The RDN of the referenced object will be primarily defined, using e.g. the LDAP resources 
as defined below. 

Now, it may be desirable to include in the name of the LDAP object a "version" and/or 
"update level" qualifier. In accordance with a further aspect of this invention, this may be 
made as follows: 

* each MIB is fully defined by its container (cluster, component type, SAP), the version of 
the cluster or the component type, and its update level; 

* for each platform update version, there is defined a corresponding platform update table, 
containing the DNs of all the MIBs being defined in that platform update version; 

* the DN of the accurate platform update table is provided for each software load version. 
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Now, in order to obtain the DN of a Referenced object> (as defined above), the relevant 
platform update table may be used to obtain the version and update level defining the 
relevant MIB configuration, and to concatenate that with the RDN previously defined for 
the Referenced object>. 

The currently available platform update table may also be searched, e.g. upon a "system 
event" in the platform to know the names of the current configuration entities, and then read 
such configurations, as desired. 

In an embodiment, only one set of LDAP data (or similar directory data) is available at a 
given time, in accordance with the current configuration of the platform, except at the time 
of a platform update, where a new set of LDAP configuration data is also available (e.g. 
mapped from a new platform update defined in OMSL). This is accompanied with a 
transactional processing of LDAP data, enabling "commit" if the change from the current 
configuration to the new one is validated, or, else, a "rollback". Then: 

- in the case of a "commit", the LDAP data corresponding to the previous configuration may 
be erased, with only the LDAP data of the new configuration remaining; 

- conversely, in the case of a "rollback", the LDAP data corresponding to the (would-be) new 
configuration may be erased, with only the LDAP data of the initial current configuration 
remaining. 

This makes it possible to avoid encumbering the LDAP data with an historical succession 
of configuration data, which may render it difficult to write new LDAP data, in an LDAP 
tree being progressively more and more encumbered. 

An example of an LDAP implementation will now be described. 

LDAP object classes may be defined, e.g. as shown in the rest of Exhibit Eh7 . The object 
classes may comprise generic object classes, and object classes related to the above defined 
entities of the OSML. Amongst the exemplary generic object classes: 
* a generic object class cgha-attribute — oc (Eh7-01) may be provided to name sub- 
entries corresponding to array or map attributes or to structure type attributes. This object 
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class contains an attribute cgha-att ribut e-name, which is used to define the RDN of 
the attribute. 

* a generic object class cgha -member — oc (Eh7-02) may be provided in order to name 
sub-entries corresponding to map or array members, or members of structure type. This 
object class contains an attribute cgha-member-name used to define the RDN of the 
member. 

* a generic object class cgha-element — oc (Eh7-03) is provided in order to name the 
map and array items. This object class contains an attribute cgha - key used to define the 
RDN of the item. 

The syntax used in mapping OMSL attributes to LDAP may be as shown in table Eh8-Tl 
in Exhibit Eh8: the Directory String syntax may be used for attributes that are RDNs 
(Relative Distinguished Names), and may be tagged as single value; the Distinguished Name 
syntax may be used for attributes that contain a DN; the "IAS" String syntax may be used 
in the remaining cases. 1 . 

The other object classes will be discussed hereinafter as needed. (The syntax and 'Value tag" 
of the attributes in the LDAP object classes is shown in Exhibit Eh7, and will not be 
commented in the following description). 4 * 

Thus, an LDAP configuration (more generally, a set of directory system configuration data) 
may be generated, using such generic attributes and object classes. In the example, these 
generic entities may be grouped into a single LDIF file, which may be used to populate the 
LDAP server with directory entries during the initialization of the OMSL Software Platform. 

In the exemplary embodiment, the directory system is used to "read" the platform 
configuration, from within the platform in use. Then, what has to be represented in LDAP 
is the platform configuration information that is described using the OMSL (e.g. CGHA- 
ML). Hereinafter, an OMSL entity that contains configuration information is termed 
"configuration-oriented " (or, in short, "configuration"). For example, a CGHA-ML attribute 
(cgha: attribute element) is "Configuration-oriented" ifit has its configuration 
attribute set to yes. 
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The following section describes how "configuration-oriented" OMSL entities may be 
mapped to LDAP entries. Other OMSL entities may be mapped to LDAP, if desired. 

Generally, each entry is composed of a set of LDAP attributes, which contains the data from 
the OMSL object, associated with the entry. Sub-entries may also be used, as it will be 
understood. 

As known, LDAP entries may be specified using an LDAP schema, which may be 
implemented as follows: 

- the schema of the LDAP server is reflected in an LDAP configuration tree (by contrast with 
a "user" tree, which contains the user data to be "read" by the platform functions); 

- the LDAP configuration tree should be updated with corresponding "schema" entries 
before importing the corresponding configuration of the platform as "user" entries in the 
LDAP server. 

- conversely, before a class can be removed from the LDAP schema, the corresponding 
entries should be removed. 

Now, mapping OMSL entities (e.g. types) to LDAP involves generating LDAP attributes 
and object classes in the LDAP schema, and therefore defining their names. 

The common LDAP naming schema of attributes and object classes is a single flat naming 
space. Thus, when mapping OMSL type identifiers to LDAP, one or more of the following 
rules may be used, as done in the exemplary embodiment: 

- certain characters are not allowed in the names of LDAP attributes and object classes. The 
period character (.) may be replaced in the mapping by the dash character (-). The underscore 
character Q may be mapped by removing it and by converting the next character into an 
uppercase character. 

- The version of the type is taken into account when this version is provided (LDAP does 
not offer explicit support for versioning). 

- The string — oc is added to object class names in order to differentiate them from 
attribute names. 
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- Each entity has an OID, which may be generated from the name of the entity, e.g. by 
concatenating the name of the entity in lower case with the addition of the string -oid, 
as currently required by LDAP servers. 

The above will be referred to as "id-mapping rules", whether taken together or in part.. 

The first level of mapping refers to generic constructs, which include the OMSL types. 

By providing that the LDAP fully qualified name of a type is unique, it may be used as a 
basis for naming LDAP entities related to this type. Thus, the LDAP naming schema may 
be further extended to name LDAP attributes corresponding to attributes of interfaces, or 
members of structures. The resulting name may be obtained by concatenating the type name 
and the sub-entry name and separating them e.g. by the dash character ( -). 

Now, a OMSL attribute may be mapped in different ways: an LDAP attribute, or an LDAP 
entry: 

- an LDAP entry may be used if the OMSL attribute is of "plural nature" (structure type, or 
map or array). The LDAP entry is provided with sub-entries, which are used to hold that 
plurality (members of the structure, or the items of the map or array). In other words, if the 
attribute is an array or a map, each item of the array or map is mapped to a sub-entry of the 
entry representing the array or map (as a whole). Thus, an object class containing only the 
LDAP attribute is generated. The name of this object class is based on the name of the 
attribute completed with the string — oc. 

- by contrast, where an OMSL attribute is "single-valued" (simple); it. may be mapped 
directly to an LDAP attribute, tagged as single value. The LDAP attribute maybe named as 
described above (id-mapping rules), along the IA5 String syntax, as shown in table Eh8-T0. 
In other words, at the object level in the LDAP schema, if the attribute is not an array or a 
map, the resulting LDAP attribute is part of the object class corresponding to the interface 
(or other object) containing the OMSL attribute. 

Table Eh8-Tl 1 shows an exemplary mapping of OMSL attribute types to LDAP in more 
detail. With reference to the row labels in Table Eh8-Tl 1 : 
* Rowl : a "simple" attribute is mapped to an LDAP attribute. 
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* Row2: in the case of a "simple" type attribute that is an array, an LDAP attribute is created 
to represent the array, together with an entity adapted to represent the items of the array. The 
entity may be in turn an object class, containing an attribute. Then, the array items are 
represented as LDAP sub-entries, instantiating the object class. 

* Row 3 : the case of an enumeration type attribute may be treated similarly: it is 
mapped to an LDAP attribute, which itself is an attribute of an LDAP object class 
corresponding to the nature of the original enumeration. 

* Row 4 : turning now to Structure Type Attributes, an attribute of structure type is mapped 
to LDAP by mapping the structure to LDAP, as described hereinafter. The configuration 
associated with the attribute is mapped as a sub-entry in the LDAP configuration tree. The 
name of the attribute is used as the RDN of the sub-entry. 

Table Eh8-T12 shows how various OMSL entities (GGHA-ML in the example) may be 
mapped to an LDAP schema. 

Consider for example the case of mapping OMSL members to LDAP Schema, as shown in 
table Eh8-Tl 2, row 2. A OMSL member is defined from a cgha : member element, in the 
exemplary CGHA-ML. Now: 

* If the OMSL member is part of a structure mapped to LDAP, it is itself mapped to LDAP 
according to its type (for example, simple type, enumeration type, structure type). 

* otherwise, a simple type member is mapped directly to an LDAP attribute, named as 
described above and tagged as single value. Concerning the "object class" level: 

- if the member is not an array or a map, the resulting LDAP attribute is part of the object 
class corresponding to the structure containing the OMSL member. 

- if the member is an array or a map, each item of the array or map is mapped to a sub-entry. 
In this way, an object class containing only the LDAP attribute is generated. The name of 
this object class is based on the identifier of the attribute completed with the string — oc. 

- a member that is itself of structure type is mapped to LDAP by mapping the structure to 
LDAP. The configuration associated with the attribute is mapped as a sub-entry in the LD AP 
configuration tree. The name of the member is used as the RDN of the sub-entry. 

After having defined the mapping the generic constructs, the MIBs will now be considered. 
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It is reminded that a MIB or Management Information Base is associated with a OMSL 
entity (SAP , component type configuration, cluster configuration, in the example), and has 
a corresponding container (cgha : sap, cgha : type, cgha : cluster , respectively) 

Each MIB may be mapped to an LDAP tree of entries, which may contain the following: 

- any OMSL object (when "configuration oriented", in the example) is mapped in this tree 
as an LDAP entry, which may have sub-entries. 

- furthermore, any OMSL object having a nested object (if "configuration oriented") is also 
mapped in this tree of entries. 

Mapping OMSL configuration to LDAP entries may be considered in the following order: 

- contents of the MIBs : Maps and Arrays, Init values, Objects, contexts ; 

- binding between the MIBs and the OMSL/LDAP configuration space : Cluster Configura- 
tion, Component Type Configuration, Component Instance Configuration, Component 
Assignment Configuration, and SAPs ; 

- overall platform update configuration: Platform Update, Software Load. 

t 

OMSL elements which are designated as a map or an array are mapped to LDAP as sub- 
entries of the LDAP entry corresponding to the map or array. (This mapping maybe used 
for objects, contexts, attributes and members). The map and array items may be named using 
the generic object class cgha-element — cc. The sub-entries belong to the LDAP 
object class corresponding to the type of the element which is a map or an array. If the 
element is of simple type, the sub-entries belong to the object class that has been created 
specifically. 

Simple type init values are mapped to LDAP using IA5 String syntax, applied to the 
string that has been used as value in the cgha : init element. 

Similarly, Enumeration init values are mapped to LDAP using IAS 
- string that is stored in LDAP is the value of the enumeration value 
element) that has been selected in the cgha : init element. 



String syntax. The 
(cgha : enumValue 



Mapping OMSL Structures is now considered. 
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Consider first reflecting in LDAP the fact that a OMSL attribute or member is of structure 
type. It is mapped to an LDAP entry (which may have sub-entries, e.g. if the attribute or 
member is an array or a map, or if one of the members of a structure is itself a structure or 
is an array or a map). The generic object class cgha-structure — oc (Eh7-04) is used. 
Its cgha-structure-type attribute defines the fully qualified type name of the 
structure. A cgha-structure-version attribute holds the structure version, 
if the structure has a version. 

Now turning to Mapping a Structure (contents), the LDAP entry of an attribute or a member 
which is a structure, but which is not an array or a map, is defined by: 

- Its DN. The identifier of the OMSL attribute or member is used as RDN. 

- Its generic object classes: 

- cgha-attribute — oc or cgha-member — oc 

- cgha-structure — oc. 

- Its generated object classes based on the type of the structure, following the mapping 
defined above. 

- Its attributes, some of which are used to store the values associated with simple type 
members. 

- Its sub-entries, used to store the values associated with structure type members. 

The case of mapping an Array or a Map of Structures will now be described. The LDAP 
entry corresponding to a structure type attribute or member that is an array or a map is 
defined by: 

- Its DN. The identifier of the OMSL attribute or member is used as RDN. 

- Its generic object classes: 

" cgha-attribute — oc, or cgha-member — oc 
- cgha-structure — oc. 

- Its sub-entries, used to store the values associated with the items of the array or map. Each 
LDAP sub-entry is defined by: 

- Its DN. The key of the item is used as RDN. 

- Its generic object classes: 

cgha-element — oc 
cgha-structure— oc 



1er depot 



47 

- Its generated object classes, based on the type of the structure, following the mapping 
defined above, 

- Its attributes, used to store the values associated with simple type members. 

- Its sub-entries, used to store the values associated with structure type members. 

Mapping Object References is now considered. A OMSL attribute or member that is an 
object reference is mapped to an LDAP entry, which may have sub-entries, e.g. if the 
attribute or member is an array or a map. The generic object class cgha-object- 
reference— oc contains the following four attributes (Eh7-05): 

- cgha-ob j ect-reference-type, which defines the fully qualified type name of the 
object reference. 

- cgha-object-reference-versipn, which defines the version of the object 
reference. 

- cgha-ob j ect-ref erence-mib-dn, which is used to store the DN of the container 
of the MIB (cluster, component type or SAP), without taking into account the version and 
update level. 

- cgha-object-ref erence-full-name, which is used to store the full name of the 
referenced object, as described. " ./ 

Thus, the LDAP entry of an attribute or a member which is an object reference, but which 
is not an array or a map, may be defined by: 

- Its DN. The identifier of the OMSL attribute or member is used as RDN. 

- Its generic object classes: 

- cgha-attribute — oc or cgha -member — oc 

- cgha-ob j ect - ref erence — oc. •/ V 

- Its generated object classes based on the type of the object reference, following the 
corresponding mapping, as above defined. 

- Its attributes. 



In order to obtain the DN of the referenced object, the platform update table 28422 (fig. 22) 
may be used to obtain the version and update level defining the MIB configuration, and to 
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concatenate that with the RDN previously defined for the cgha-obj ect-ref erence- 
full-name attribute. 

Mapping an Array or a Map of Object References is now considered. The LDAP entry 
corresponding to an object reference type attribute or member that is an array or a map is 
defined by: 

- Its DN. The identifier of the OMSL attribute or member is used as RDN. 

- Its generic object classes: 

- cgha-attribute — oc or cgha -member — oc 
- cgha-object-ref erence — oc. 

- Its sub-entries used to store the values associated with the items of the array or map. Each 
LDAP sub-entry is defined by: 

- Its DN. The key of the item is used as RDN. 

- Its generic object classes, cgha-element— oc, cgha-obj ect- 
reference — oc 

- Its generated object classes, based on the type of the object reference, following the 
mapping defined above for Object References. 

- Its attributes, some of which may be used to store the values associated with simple type 
members. 

Mapping OMSL References is now considered. A OMSL attribute or member that is a 
reference and that is part of the configuration is mapped to an LDAP entry, which may have 
sub-entries. Sub-entries are necessary if the attribute or member is an array or a map. The 
generic object class cgha-ref erence— oc contains the following two attributes: 

- cgha - reference- type, which defines the fully qualified type name of the reference. 

- cgha-ref erence-dn, which is used to store the DN of the referenced component 
instance or assignment. 

Mapping a Reference (per se) may now be described. The LDAP entry of an attribute or a 
member which is a reference, but which is not an array or a map, is defined by: 

- Its DN. The identifier of the OMSL attribute or member is used as RDN. 

- Its generic object classes: 
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- cgha-attribute--oc if it is an attribute or cgha -member — oc ifitisa 
member 

- cgha-ref erence— oc, 

- Its generated object classes based on the type of the reference, following the mapping 
defined above for References 

- Its attributes. 

Turning now to mapping an Array or a Map of References, the LDAP entry corresponding 
to a reference type attribute or member that is an array or a map is defined by : 

- Its DN. The identifier of the OMSL attribute or member is used as RDN. 

- Its generic object classes: 

. - cgha-attribute — oc or cgha -member — oc 

- cgha-ref erence— oc. 

- Its sub-entries used to store the values associated with the items of the array or map. Each 
LDAP sub-entry is defined by: 

- Its DN. The key of the item is used as RDN. 

- Its generic object classes: 

cgha-element — oc 
cgha-ref erence — oc 

- Its generated object classes, based on the type of the reference, following the 
mapping defined above for References 

- Its attributes. 

Mapping Objects to LDAP is now considered. 

A OMSL object (specified e.g. with cgha: object) that implement^ an interface 
containing configuration attributes is called a configuration[-oriented] object. Each 
configuration object is mapped to an LDAP entry, with LDAP sub-entries if the implemen- 
ted interface contains map or array attributes or structure type attributes. If the object 
contains nested objects that are also configuration objects, they are mapped as sub-entries 
of the entry corresponding to the enclosing object. 
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The generic object class cgha-ob j ect-oc (Eh7-07) contains one attribute cgha- 
ob j ect -name used to define the RDN of the object in the LDAP tree. 

The generic object class cgha-interf ace-oc (Eh7-08) contains the following two 
attributes: 

-Anattributenamedcgha-interface-type that defines the fully qualified type name 
of the interface. 

- An attribute named cgha-interf ace-version that holds the version of the 
interface. 

An object that implements a singleton interface and that is a configuration object, is mapped 
directly in the containing SAP. This means that the generated object class is added to the list 
of object classes provided by the LDAP entry corresponding to the SAP (as described). If 
the object contains nested configuration objects and if it is not a configuration object itself, 
the associated entry belongs only to the object class cgha-ob j ect — oc. 

Mapping an Object That Is Not a Map to LDAP is now considered. The LDAP entry that 
corresponds to a configuration object is defined by: 

- Its DN. The identifier of the OMSL object is used as RDN. 

- Its generic object classes: 

- cgha-object--oc. 

- cgha-interf ace — oc. 

- Its generated object class(es) based on the type of the interface(s) implemented by the 
object. There is an object class for the interface implemented by the object and for each of 
the ancestors of that interface. 

- Its attributes. 

- Its sub-entries, used to store the values corresponding to: 

- Structure type attributes. 

- Nested objects or contexts. 



The generic attributes cgha-interf ace-type and cgha-interf ace-, 
are initialized to define the folly qualified type name and version of the interface that is 



-version 
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implemented by the object. The LDAP attribute resulting from mapping the category 
attribute is initialized based on the value provided in the configuration. 

Mapping a Map of Objects to LDAP is now considered. The LDAP entry that corresponds 
to a map of configuration objects is defined by: 

- Its DN. The identifier of the OMSL object may be used as RDN. 

- Its generic object classes : cgha-object--oc.and cgha-interface — oc. 

- Its sub-entries, used to store the values corresponding to each item of the map. Each LDAP 
sub-entry is defined by : 

- Its DN. The key of the map item is used as RDN. 

- Its generic object classes cgha-element-oc and cgha-interface— oc. 

- Its generated object class(es) based on the type of the interface(s) implemented by 
the object. 

- Its attributes. 

- Its sub-entries (if any). 

Mapping OMSL Contexts to LDAP is now considered. 

A OMSL context (specified using the cgha: context element) that contains nested 
configuration objects is mapped to an LDAP entry. The nested configuration objects are 
mapped as sub-entries of the entry corresponding to the context. If the context corresponds 
to a map, the items of the map are mapped to sub-entries of the entry corresponding to the 

context. V 

* / 

t - 

The generic object class cgha-context — oc { Eh7-09) contains one attribute, cgha- 
context -name, which is used to define the RDN of the entry in the LDAP tree. 

Mapping a Context That Is Not a Map to LDAP is now considered. The LDAP entry that 
is associated with a context that is not a map is defined by: 

- Its DN. 

- A generic object class cgha-context— oc. 

- Its sub-entries, which are used to map nested objects or contexts. 
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Mapping a Context That Is a Map to LDAP is now considered. The LDAP entry that is 
associated with a context that is not a map is defined by: 

- Its DN. 

- the generic object class cgha-context — oc. 

- Its sub-entries, which are used to map the items of the map, and nested objects or contexts. 
Each LDAP sub-entry is defined by: 

- Its DN. The key of the map item is used as RDN. 

- Its generic object class cgha-context— oc 

- Its sub-entries. 

Mapping OMSL Cluster Configuration to LDAP is now considered. 

The cluster configuration may be mapped as sub-entries of the LDAP entry 
ou=cluster, o=cgha_root. The cluster configuration may be mapped taking into 
account its version and its update level. The cluster configuration MIB is mapped as sub- 
entries of the resulting entry. The first sub-entry corresponds to the version of the cluster 
configuration. Its update level is nested inside the version sub-entry. The MIB (hierarchical 
tree of objects associated with the MIB) is nested within the update level sub-entry. 

The version is mapped to an LDAP entry that belongs to the generic object class cgha- 
cluster-version— oc. This object class (Eh7-O10) contains one attribute cgha- 
cluster-version used to define the version of the configuration. 

The update level is mapped to an LDAP entry that belongs to the generic object class 
cgha-cluster-update-level— oc. This object class (Eh7-OH) contains one 
attribute cgha-cluster-update-level used to define the update level of the 
configuration. 

Mapping OMSL Component Type Configuration to LDAP is now considered. Component 
type configuration is mapped as sub-entries of the LDAP entry 
ou=types , o=cgha root. 
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Component type configuration is mapped taking into account the fully qualified type name 
of the component, its version and its update level. The component type configuration MIB 
is mapped as sub-entries of the resulting entry. 

The fully qualified type name is mapped to an LDAP entry that belongs to the generic object 
class cgha -component -type— oc. This object class (Eh7-012) contains one attribute 
cgha -component - 1 ype used to define the fully qualified type name of the component. 

The version is mapped to an LDAP entry that belongs to the generic object class cgha- 
c omp onent-type - version— oc. This obj ect class (Eh7-0 13) contains one attribute 
cgha-component-type-version used to define the version of the component. 

The update level is mapped to an LDAP entry that belongs to the generic object class 
cgha-component-type-update-level-~oc.This obj ect class (Eh7-0 14) contains 
one attribute cgha-component-type-update-level used to define the update 
level of the configuration. 

Mapping OMSL Component Instance Configuration to LDAP is now considered. i 

Component instance configuration is mapped as sub-trees of the LDAP entry 
ou=instances, o=cgha_root. Component instance configuration is mapped taking 
into account its identifier, the identifier of the SAP containing the configuration, the 
component type version and the update level of the instance configuration. The MIBs 
corresponding to the component instance configuration are mapped as sub-entries of the 
resulting entry. 

The component instance identifier is mapped to an LDAP entry that belongs to the generic 
object class cgha-component-instance-name— oc. This object class (Eh7-015) 
contains two attributes: 

- cgha-component-instance-name used to define the identifier of the instance. 

- cgha-component-type used to define the fully qualified type name of the instance. 
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The component instance update level is mapped to an LDAP entry that belongs to the 
genericobjectclasscgha-component-instance-update-level— oc. This object 
class (Eh7-016) contains one attribute cgha-component-instance-update- 
level used to define the update level of the configuration. 

Mapping OMSL Component Assignment Configuration is now considered. 

Component assignment configuration is mapped as sub-trees of the LDAP entry 
ou=assignments, o=cgha_root. Component assignment configuration is mapped 
taking into account its identifier, the identifier of the SAP containing the configuration, the 
component type version and the update level of the assignment configuration. The 
component assignment 

configuration MIBs are mapped as sub-entries of the resulting entry. The identifier is 
mapped to an LDAP entry that belongs to a generic object class cgha-component- 
assignment-name— oc. This object class (Eh7-017) contains two attributes: 
-cgha-component-assignment-narae used to define the name of the assignment. 
- cgha-component-type used to define the component type of the assignment. 

The component assignment update level is mapped to an LDAP entry that belongs to a 
generic object class cgha-component-assignment-update-level— oc. This 
object class (Eh7-018) contains one attribute cgha-component-assignment- 
update-level used to define the update level of the configuration. 

Mapping OMSL S APs to LDAP is now considered. SAPs are defined using the cgha : s ap 
element (as specified above). SAPs are mapped to LDAP as sub-entries of the entry 
corresponding to the component instance (as described above) or component assignment (as 
described above) that contains the SAP. 

The name is mapped to an LDAP entry that belongs to the generic object class cgha - s ap- 
narne— oc. This object class (Eh7-019) contains two attributes: 
- cgha-sap-name used to define the name of the SAP. 
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- cgha-sap-access used to specify whether the SAP will be exposed to a supervisor 
authority, e.g. an OMC (Operation & Management Center). 

The value management indicates that the SAP is exposed to the OMC. The value 
cluster indicates that the SAP is only exposed to cluster components. 

Mapping the OMSL Platform Update to LDAP is now considered. 

In order to provide a consistent view of the Network Element configuration, it is desirable 
to generate the list of update levels associated with all the MIBs defined in the platform 
update (specified using the cgha : plat f ormUpdate element). This list is implemented 
in LDAP as a sub-entry of the LDAP entry ou=platform_updates , o=cgha_root. 
The list is implemented taking into account the version of the platform update: the version 
is mapped as the first sub-entry of ou^platf orm_updates, o=cgha_root, and the 
list of update levels is nested inside the sub-entry corresponding to the version. One entry 
in the list of update levels is generated per MIB. 

The version is mapped to an LDAP entry that belongs to a generic object class cgha- 
plat f orm-updat e-ver sion-oc. This object class (Eh7-O20) contains one attribute 
cgha-plat form-update- vers ion used to define the version of the platform update. 

The list of MIB update levels is implemented in LDAP as a set of entries belonging to a 
generic object class cgha-update-level — oc. This object class (Eh7-021) contains 
three attributes: 

- the attribute cgha-component-update-level, which is used to define the RDN of 
the element in the list. Its value is the DN of the MIB including the associated version. 

- the attribute cgha- component -upd a t e-level ^dn, which is used to define the DN 
of the MIB, including its update level . * 

- the attribute cgha-upda ted, which is used to define if the MIB has been updated in the 
platform update. This attribute is set to 1 if the MIB has been updated and to 0, otherwise. 

Mapping the OMSL Software Load to LDAP is now considered. 
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The software load version provides the means to access the correct version of the platform 
update table. This is implemented in LDAP as a sub-entries of the LDAP entry 
ou=sof tware^loads , o=cgha_root, taking into account the version of the software 
load. 

The version is mapped to an LDAP entry that belongs to a generic object class cgha- 
software-load-version — oc.This object class (Eh7-022) contains two attributes: 

- cgha-sof tware-load-version, used to define the version of the software load. 

- cgha-plat f orm-update-dn, used to define the DN of the current platform update 
table. This current platform update table corresponds to that defined by the 
<prefix> . appl y . ldi f file (described hereinafter). 

A file used to apply the platform update may contain the entry as shown in second place, 
which sets the current platform update DN. 

Removing LDAP Entries is now considered. LDAP entries must be removed before 
removing object classes and attributes from the LDAP schema. The following syntax is used 
to remove LDAP entries: 

dn: dnValue 

changetype: delete 
where dn : dn Value corresponds to the DN of the entry to be removed. 

The Generated Files are now considered, with reference to Figure 22. The tool (named e.g. 
ml 2 conf ig) may be used to map naming and configuration data to LDAP, relying on the 
above described mapping scheme. 

The resulting LDAP information is organized into a set of files. Before initialization, these 
files are uploaded onto the cluster by the software load tools. The files can then be used by 
the OMSL Software Platform to populate the LDAP server running on each cluster during 
initialization. 

Each file defining a platform update (using the cgha : plat f ormUpdate element) is 
mapped to a plurality of files, defined below, where <prefix> is the concatenation of the 
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identifier and the version of the platform update, separated by a period character (.). Note 
that <prefix> is shown as "platformUpdate.version" in figure 22. The files may be: 

* <prefix> . populate . Idif . This file contains: 

- The attributes and the object classes, resulting from mapping the new OMSL types 
provided in the platform update. 

- The entries, resulting from mapping the configuration provided in the platform 
update. 

- The MIB update levels table. 

* <prefix>\ apply. Idif. This file defines the current platform update version, 
corresponding to the current software load. This is done by defining the current platform 
update table DN in the software load entries. 

* <prefix> . remove . Idif .This file is used to remove from the LDAP server -all the 
information that does not belong to the current platform update. 

* <preflx> . rollback . Idif . This file is used to roll back the LDAP server to its state ; 
before applying the <prefix> . apply . Idif file. , ... *■ 

* <prefix> . cleanup. Idif. This file is used to remove from the LDAP server all the 
entries that have been added by applying the <preftx>. populate .Idif file. 

* <prefvc> . next. xml. This file gives a brief description of the platform in order to be 
able to perform the next platform update. 

. 

The LDIF files can then be loaded onto the LDAP server, depending on the platform update 
strategy, as described below. 

The OMSL Software Platform is updated in a controlled manner in order to apply a new 
platform update defining a software load and a configuration update to the platform. 
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First of all, the LDAP server is populated vising the <prefix> .populate . ldif described 
above. The LDAP server can be populated in advance. The <prefix> . apply, ldif file 
provides the DN of the current platform update table, and hence the platform takes into 
account the new configuration update and software load. One of two possible scenarios then 
occurs: 

The platform update is successful: the platform and all its components continue to run 
correctly. In this case, the OMC (Operation & Management Center) gives the instruction to 
commit. All the information that does not belong to the current platform update must then 
be removed from the LDAP server, using the <prefix> . remove .ldif file. 

The platform update is unsuccessful: one or more components fail to run correctly and the 
OMC gives the instruction to rollback. In this case, the <prefix> . rollback . ldif file 
must be used to return the LDAP server to its previous state. This file provides the DN of 
the previous platform update table, thus enabling the platform to run using the previous 
configuration load and software load. Finally, in case of rollback, it is necessary to clean up 
the LDAP server, using <prefix> . cleanup . ldi f . This removes all the entries that were 
added during population of the LDAP server. 

In both cases, the platform returns to a stable state after the update process. In the second 
case, when the OMC gives the instruction to rollback, the new state of the platform is 
exactly equivalent to the previous one. 

Basically, the OMSL-to-LDAP mapping may be applied to the MIBs. By way of example, 
Exhibit Eh9 shows a mapping of a component type configuration MIB. 

The OMSL code (here, CGHA-ML) for the MIB is shown at Eh9 - A. The MIB defines an 
object named component Descriptor , corresponding to version 1 of a boot server. 
Assuming this is update level 1 of the configuration, the corresponding LDAP ("user") 
entry may be as shown at Eh9-B. The relative Distinguished Name or RDN is cgha- 
ob j ect-name=componentDescriptor. 
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It will be understood that other OMSL entities of the MIBs may be mapped to LDAP, on the 
basis of the above described mapping schemes. In the exemplary embodiment, only the 
"configuration oriented" OMSL entities are mapped to LDAP. However, other OMSL 
entities may be mapped to LDAP as well. 

Also, there has been proposed an OMSL language (being both Operational and Modeling), 
and a mapping to a directory system language (or DSSL) to represent the current condition 
of the platform ("current load"), and, if desired, a possible new condition ("software load"). 

Accordingly, this aspect of this invention allows one or more of the following: 

- upgrade modification of the schema defining the configuration state of the platform; 

- downgrade modification of the schema defining the configuration state; 

- upgrade modification of the configuration state of the platform; 

- downgrade modification of the configuration state; 

- commit of the configuration modification; 

- rollback of the configuration modification; 

- uniform access to the configuration. 

i 

- • // ' r 

This invention also encompasses a platform, at runtime, having the above described LDAP 
data, however not the OS ML data from which such LDAP data have been mapped. It will- 
also be appreciated that this includes the possibility that the DSSL be directly used as an 
Operational and Modeling Language, at least in part, e.g. for the configuration oriented 
information , as described. 

This invention is of interest in the case of a redundant platform, as it has appeared from the 
above description. However, this should not be seen as a necessary feature, and the invention 
may also apply to a non redundant platform as well. - f ' 

More generally, this invention covers a platform and/or its parts, whether considered at the 
level of design, or at runtime. It further covers various corresponding methods, as they niay 
be extracted from the above description. 



1 er depot 



60 

Thus, there is proposed a method of preparing loadable software for a platform, the method 
comprising the steps of: 

a. preparing first data (e.g. at the model level of items 2010 and 2020 in figure 9) defining 
a given software to be loaded, 

b. generating second data from said first data, said second data comprising identifiers of 
software elements to be loaded (e.g. item 2030 in figure 9), and 

c. generating third data from said second data, and from a definition of the platform on 
which the third software load data is to be loaded (e.g. items 1570, 2400 and/or 2500 in 
figure 10). 

There is also proposed an apparatus for aiding software load in a platform, said apparatus 
comprising: 

- a package repository, 

- a model repository, and 

- software load aiding code, interacting with the package repository and the model 
repository, 

said software load aiding code being capable of converting an expression of a software load 
in a model language into a combination of code and configuration data being valid for 
execution in the platform. 

The above method and apparatus are subject, optionally, to all the refinements described 
herein. 



Independently, the features of a platform in operation are encompassed, as well as the 
methods involved in its operation. This includes, but is not limited to, the directory server 
and/or LDAP aspects. 

This invention also covers the software code as used in this invention, especially when made 
available on any appropriate computer-readable medium. The expression "computer- 
readable medium" includes a storage medium such as magnetic or optic, as well as a 
transmission medium such as a digital or analog signal. 
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The software code basically includes, separately or together, the codes as used when writing 
the OSML and/or LDAP files (or equivalent), and/or accompanying executable code or 
macros (or equivalent), e.g. in LDAP, as well as precursors and/or generators of such codes, 
and as the resulting code, as applicable e.g. in a platform and/or directory server. The 
invention also encompasses the combinations of such codes with language dependent and/or 
hardware dependent code and/or data. The invention also encompasses an operating system, 
comprising part or all of such code. 

(X 
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Exhibit Ehl - Exemplary Document Type Definition (DTD) 



The DTD is as shown in the right column of the following table. The identifying labels b 
the left column form no part of the DTD. 





<?xml version="1.0" encoding="us-ascii" ?> 




<!--CGHAML DTDident "@ {# ) cghaml . dtd 1,34 01/07/19 SMI"— > 


A 




Al 


< ! ELEMENT cgha : description (#PCDATA)> 


A2 


<! ELEMENT cgha : import 




(cgha : description?) > 




< ! ATTLIST cgha: import 




href CDATA #REQUIRED> ! 


A3 


<! ELEMENT cgha: package 




(cgha: description?, 




cgha: import*, 




( (cgha interface ( 




cgha : structure | 




cgha : enumeration | 




cgha:objectReference I 




cgha : reference | 




cgha: exception 1 




cgha: event) * | 




cgha : component ) ) > 




<! ATTLIST cgha: package 




name CDATA #REQUIRED> 


B 


<! — Interface Model — > ! 


Bl 


<! ELEMENT cgha : interface 




(cgha : description?, 




cgha : inherit?, 




cgha: constant*, 




(cgha : attribute | 




cgha : operation) *, 




cgha :publish*) > 




< ! ATTLIST cgha interface 




type CDATA # REQUIRED 




version CDATA # REQUIRED 




leaf (yes|no) 'no' 




native (yes I no) 'no' 




singleton (yes | no) 'no'> 


B2 


< ! ELEMENT cgha : inherit 




(cgha description?) > 




< ! ATTLIST cgha .-inherit 




type CDATA # REQUIRED 




version CDATA #REQUIRED> 
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B3 



B4 



<! ELEMENT cgha : constant 
(cgha : description?) > 
< ! ATTLIST cgha: constant 
name CDATA # REQUIRED 
type CDATA # REQUIRED 
value CDATA #REQUIRED> 



<! ELEMENT cgha : attribute 
(cgha : description?, 
cgha :init*) > 

<! ATTLIST cgha: attribute 
name CDATA # REQUIRED 
type CDATA # REQUIRED 
version CDATA # IMPLIED 
array (yes | no) 'no' 
map (yes | no) 'no' 
mode (R|RW) 'RW 
configuration (yes (no) 'no'> 



B5 



<! ELEMENT cgha : init 
{cgha description?, 
cgha : init* ) > 
< I ATTLIST cgha: init 
name CDATA # IMPLIED 
member CDATA # IMPLIED 
attribute CDATA #IMPLIED 
reference CDATA # IMPLIED 
key CDATA # IMPLIED 
value CDATA IMPLIED 
final (yes | no) 'no'> 



B6 


<! ELEMENT cgha : operation 
(cgha : description?, 
cgha : request?, 
cgha : reply?, 
cgha : raise*) > 
<! ATTLIST cgha : operation 
name CDATA # REQUIRED 
mode (rpc | oneway) 'rpc'> 








B7 


<! ELEMENT cgha: request 
(cgha : description? , 
cgha : parameter^ ) > 








B8 


< ! ELEMENT cgha : reply 
(cgha description?, 
cgha:parameter+) > 









B9 



<! ELEMENT cgha .-parameter 
(cgha : description?) > 
<! ATTLIST cgha : parameter 
name CDATA # REQUIRED 
type CDATA # REQUIRED 
version CDATA # IMPLIED 
array (yes I no) 'no'> 
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BIO 


<! ELEMENT cgha : structure 
(cgha: description?, 
cgha : member*) > 
< ! ATTLIST cgha: structure 
type CDATA # REQUIRED 
version CDATA #IMPLIED> 


Bll 


< ! ELEMENT cgha : member 
{cgha : description? ) > 
<! ATTLIST cgha : member 
name CDATA # REQUIRED 
type CDATA # REQUIRED 
version CDATA # IMPLIED 
array (yes | no) 'no' 
map (yes I no) 'no'> 


B12 


<! ELEMENT cgha : enumeration 
(cgha : description? , 
cgha : enumValue*) > 
<! ATTLIST cgha : enumeration 
type CDATA # REQUIRED 
version CDATA #IMPLIED> 


B13 


< ! ELEMENT cgha : enumValue 
(cgha : description?) > 
<! ATTLIST cgha : enumValue 
name CDATA # REQUIRED 
value CDATA #IMPLIED> 


B14 


<! ELEMENT cgha : obj ectRef erence 

(cgha : description?) > 

<! ATTLIST cgha : obj ectRef erence 

type CDATA # REQUIRED 

version CDATA # REQUIRED 

referencedObjectType CDATA # REQUIRED 

ref erencedObjectVersion CDATA #REQUIRED> 


B15 


< ! ELEMENT cgha : re f erence 
(cgha : description? ) > 
<! ATTLIST cgha : ref erence 
type CDATA #REQUIRED> 


B16 


<! ELEMENT cgha: raise 
(cgha : description? ) > 
<! ATTLIST cgha: raise 
type CDATA # REQUIRED 
version CDATA #IMPLIED> 


B17 


<! ELEMENT cgha : exception 
(cgha : description?, 
cgha : member* ) > 
<! ATTLIST cgha : exception 
type CDATA # REQUIRED 
version CDATA #IMPLIED> 
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5 



B18 


<! ELEMENT cgha : publish 
(cgha:description?) > 
< ! ATTLIST cgha:publish 
type CDATA # REQUIRED 
version CDATA #REQUIRED> 


B19 


<! ELEMENT cgha: event 
(cgha : description? r 
cgha : member *) > 

<! ATTLIST cgha: event 1 
type CDATA # REQUIRED f 
version CDATA #REQUIRED> 1 


C 


<! — Component Model — > j 


CI 


<! ELEMENT cgha : component | 
(cgha : description?, 1 
cgha:"use*, I 
cgha: type, 
cgha: sap* )> 

<! ATTLIST cgha : component 1 
type CDATA #REQUIRED I 
version CDATA #REQUIRED> j 


C2 


<! ELEMENT cgha: use J 
(cgha : description?) > 1 
<! ATTLIST cgha: use 

type CDATA # REQUIRED 1 
minVersion CDATA # REQUIRED 1 
maxVersion CDATA #REQUIRED> ' 


C3 


<! ELEMENT cgha : type j 
(cgha description?, 1 
cgha : provide* , 1 
cgha:mib)> 1 


C4 


<! ELEMENT cgha : sap 1 
(cgha:description?, > 1 
cgha:provide*, J 
cgha :mib?) > ' > • [ 
<! ATTLIST cgha:sap j 
name CDATA # REQUIRED . I 
scope (instance | assignment) # REQUIRED , . 1 
access (cluster jmanagement) 'managements | 


C5 


<! ELEMENT cgha: provide / * 
(cgha : description? ) > | 
<! ATTLIST cgha: provide „ " j 
type CDATA # REQUIRED J 
minVersion CDATA # REQUIRED J 
maxVersion CDATA #REQUIRED> 1 


C6 


<! ELEMENT cgha:mib I 
(cgha: description?, - - - 
(cgha : context j J 
cgha : object) *) > | 



(X 
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5 



C7 


< ! ELEMENT cgha : context 

(cgha : description? , 

(cgha : context | 

cgha: object) *) > 

< ) ATTLIST cgha: context 

name CDATA # REQUIRED 

map (yes | no) 'no' > 


C8 


<! ELEMENT cgha: object 

(cgha description?, 

(cgha:init*, 

(cgha : context I 

cgha : ob j ect ) * ) ) > 

<! ATTLIST cgha: object 

name CDATA #IMPLIED 

type CDATA # REQUIRED 

map { yes | no ) ' no' > 


D 


<! --Software Load Model — -> 


Dl 


< ! ELEMENT cgha : sof twareLoad 

(cgha description?, 

cgha : import* , 

cgha : cluster, 

cgha : componentLoad* ) > 

< ! ATTLIST cgha : sof twareLoad 

name CDATA # REQUIRED 

version CDATA #REQUIRED> 


D2 . 


< I ELEMENT cgha: cluster 
(cgha : description? , 
cgha : provide*, 
cgha :mib) > 

<\ ATTLIST cgha: cluster 
version CDATA #REQUIRED> 


D3 


< ! ELEMENT cgha : componentLoad 
{cgha : description?, 
cgha:init*)> 

<! ATTLIST cgha : componentLoad 
type CDATA # REQUIRED 

version CDATA #REQUIRED> j 


E 


<! --Configuration Update Model — > 


El 


< ! ELEMENT cgha : conf igurationUpdate 
(cgha description?, 
cgha : import*, 

cgha : sof twareLoadDefinition, 
cgha : clusterConf iguration? , 
(cgha : typeConf iguration j 

cgha :instanceConf iguration I j 
cgha : assignmentConf iguration | 
cgha : remove Instance | 
cgha : remove Assignment ) *) > 

<! ATTLIST cgha: conf igurationUpdate j 
name CDATA # REQUIRED 
version CDATA #REQUIRED> 
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10 



E2 


< ! ELEMENT cgha : sof twareLoadDef inition 
(cgha:description?) > 

< ! ATTLIST cgha: sof twareLoadDef inition 
name CDATA # REQUIRED 
version CDATA #REQUIRED> 


E3 


<! ELEMENT cgha : clusterConf iguration 

(cgha .-description?, 

cgha:init*)> 


E4 


<! ELEMENT cgha : typeConf iguration j 
(cgha : description?, 

cgha:init*)> j 
< ! ATTLIST cgha: typeConf iguration J 
type CDATA #REQUIRED> j 


E5 


<! ELEMENT cgha : ins tanceConf iguration 

(cgha description?, I 
cgha: sapConf iguration* ) > 

< ! ATTLIST cgha : instanceConf iguration 1 
name CDATA # REQUIRED 

type CDATA #REQUIRED> | 


E6 


<! ELEMENT cgha : assignmentConf iguration j 
(cgha : description?, j 
cgha :sapConf iguration* ) > -J 
<! ATTLIST cgha : assignmentConf iguration 1 
name CDATA # REQUIRED 1 
type CDATA #REQUIRED> I 


E7 


< I ELEMENT cgha : sapConf iguration j 
(cgha description?, j 
cgha:init*)> I 
<! ATTLIST baha : saDConf i mir^ i- i «n 1 
name CDATA #REQUIRED> ' 1 


E8 


<! ELEMENT cgha : removelns tance 

(cgha:description?) > 1 
<! ATTLIST cgha : removelns tance I 
name CDATA #REQUIRED> ^ ' j 


E9 


<! ELEMENT cgha : removeAssignment 1 
(cgha : description?) > [ 
<! ATTLIST cgha: removeAssignment . j 
name CDATA #REQUIRED> 


F 


< ! — Platform Update Model — > 


Fl 


<! ELEMENT cgha : platf ormUpdate * j 
( cgha : description? , 
cgha : import*, 

cgha : currentLoadDef inition? , 

^.vjiia . out uwaicli\jaUUcIlIllLlOn f 

cgha :conf igurationUpdateDef inition*) > 
< .'ATTLIST cgha: platf ormUpdate 
name CDATA # REQUIRED 
version CDATA # REQUIRED 
configuration (load | update) ' update' > 
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F2 


<! ELEMENT cgha : currentLoadDef inition 
(cgha : description?) > 

< ! ATTLIST cgha: currentLoadDef inition j 
version CDATA #REQUIRED> J 


F3 


<! ELEMENT cgha : conf igurationUpdateDef inition 

(cgha : description? ) > I 
<! ATTLIST cgha: conf igurationUpdateDef inition 
name CDATA # REQUIRED 
version CDATA #REQUIRED> 


F4 


<! ELEMENT cgha : currentLoad j 
(cgha: import*, 

cgha : currentCluster, [ 
(cgha : currentType | 

cgha; currentlnstance I j 
cgha: current Assignment) *) > 

<! ATTLIST cgha: currentLoad j 
version CDATA # REQUIRED J 
platformUpdateName CDATA # REQUIRED 

plat formUpdat eVer si on CDATA # REQUIRED I 
softwareLoadName CDATA # REQUIRED 

softwareLoadVersion CDATA #REQUIRED> j 


F5 


<! ELEMENT cgha : currentCluster j 
(cgha: provide*, 

cgha:mib)> I 
< .'ATTLIST cgha: currentCluster [ 
version CDATA # REQUIRED 

updateLevel CDATA #REQUIRED> j 


F6 


<! ELEMENT cgha : currentType ^| 
(cgha: init* ) > I 
<! ATTLIST cgha: currentType j 
type CDATA # REQUIRED 

version CDATA # REQUIRED j 
updateLevel CDATA #REQUIRED> 


F7 


<! ELEMENT cgha : currentlnstance j 
{cgha : sapConf iguration*) > | 
<! ATTLIST cgha: currentlnstance 

name CDATA # REQUIRED j 
type CDATA # REQUIRED j 
updateLevel CDATA #REQUIRED> [ 


F8 


< J ELEMENT cgha : cur rentAssignment j 
(cgha : sapConf iguration* ) > j 
< ! ATTLIST cgha : currentAssignment I 
name CDATA # REQUIRED I 
type CDATA # REQUIRED j 
updateLevel CDATA #REQUIRED> I 
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Exhibit Eh2 - Tables describing elements of the DTD 

In each table, the upper leftmost cell repeats the label of the element being described, as it 
appears in the DTD of Exhibit Ehl . The upper rightmost cell repeats the name of the 
element in the DTD. The next rows discuss attributes, if any. One or more last rows (single 
column) may recite the sub-elements, if any, and may also include notes. 



A3 


cgha : package 


name 


Specifies the package identifier. 

By convention, the name of a package begins with the reversed DNS name of the 
organization that created or controls the package. That organization can then organize 
the namespace of its packages according to its own requirements. 


Sub-elements: 

* An optional list of imported files, using cgha : Import. ** \ 

Files that can be imported are files that specify a cgha : package - 

* A list of type definitions, from the above set of type definitions. 



Bl 


cgha : interface ; v 


type 


Specifies the identifier of the currently defined interface. 


version 


Specifies the version of the interface, a positive integer. 


leaf 


Specifies inheritance. If the leaf attribute is set to "yes", no other interface 
may inherit from this one. The default value of this attribute is "no ". 


native 


Specifies whether code is generated by compilation of the currently defined 
interface. If the native attribute is set to "yes", no code is generated. The 
default value of this attribute is "no". This mechanism allows the smooth 
integration of code, developed with specific semantics, into the global model. 


singleton 


Makes it possible to associate a procedural model with each SAP. A singleton 
interface can only be accessed by requiring a reference to the SAP that contains 
an instance of it. Therefore, only one object per SAP can be an instance of a 
singleton interface. If the singleton attribute is set to "yes", the interface is 
a singleton interface. The default value of this attribute is "no". 



(X 
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Bl | cgha : interface | 

Sub-elements: 

* An optional inheritance field (cgha : inherit) . 

* An optional list of constants ( cgha : cons tan t ) . 

* An optional list of attributes and/or operations (cgha : attribute and/or 
cgha : operation) . 

*An optional list of event types ( cgha : publish) . All the event types that might be published 
by an object implementing the currently defined interface must be present in the list. 



|B2 


cgha : inherit 


type 


Specifies the fully qualified type name of the base interface from which the 
currently specified interface inherits. 


version 


Specifies the version of the base interface. 


Note: An interface with the corresponding type and version must have been previously 
defined. 






B3 


cgha : constant 


name 


Specifies the identifier of the constant. 


type 


Specifies the type of the constant. This type must be a simple type. 


value 


Specifies the value of the constant. The value must be compatible with the type 
of the constant. 


Sub-elements: none 



|B4 


cgha : attribute j 


name 


Specifies the identifier of the interface attribute. 


type 


Specifies the type of the interface attribute: either a simple type or one of 
the following types: a structure, an enumeration, a reference, an object 
reference. For all types which are not simple types, the type attribute 
specifies the fully qualified type name. 


version 


Specifies the version of the attribute type (optional). 


array 


Specifies whether the attribute is an array. If the attribute is set to "yes", 
the attribute is an array. The default value of this attribute is "no" 



1 er depot 



71 



|B4 


cgha : attribute 


map 


Specifies whether the attribute is a map. If the map attribute is set to 
"yes", the attribute is a map. The default value of this attribute is "no". 


mode 


Specifies the read/write permissions for accessing the attribute from the 
perspective of the interface client. The default permissions are read and 
write (RW). Ifthe permissions are set to read (R) no write access is 
provided to the client. 


configuration 


Specifies whether the attribute is configuration information. The default 
value for the configuration attribute is "no". Configuration 
attributes are stored in the Cluster Configuration Repository (LDAP). 
Configuration attributes must be initialized. The initialization is done 
using cgha : init elements. This initialization can be done at interface 
definition level, at component definition level, at software load definition 
level or at configuration update level. The attribute type defined by the 
type and version attributes must have been previously defined. 


Sub-elements: 

* an optional list of initial values ( cgha : init) 



B5 cgha: init 


name 


Specifies the identifier of the object being initialized. This attribute must be set 
when initializing a specific object in the initialization of a MIB. 


member 


Specifies the member of a structure being initialized. This attribute must be set 
when initializing a specific member in the initialization of a structure. 


reference 


Identifies the referenced object or component. For a referenced object, the 
reference attribute is set to object. For a referenced component, the reference 
attribute is set to instance or assignment depending on the scope of the compo- 
nent. This information enables the value attribute to be interpreted correctly 
when reference and object reference type attributes are initialized. 


attribute 


Specifies which attribute is being initialized. This attribute must be set when 
initializing a specific attribute of an object. 


key 


Specifies the key of the item being initialized. This must be set when initializing 
a specific item in an array of items or in a map of items. For a map of items, its 
value can be any string. For an array of items, its value must be an integer value 
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B5 


cgha: init 


value 


Specifies the value of a simple type attribute or member (leaf in the initialization 
tree). The value must be compatible with the type of the attribute or member. 


final 


Controls the initialization semantics 


Sub-elements: none 




B6 


cgha : operation 


name 


Specifies the identifier of the operation. 


mode 


Specifies the semantics of the operation. Two modes can be specified: synchro- 
nous operation, specified using rpc, and one-way operation, specified using 
oneway. Synchronous operation means that the caller of the operation waits for 
it to complete before proceeding. One-way operation means that the caller of the 
operation does not wait for it to complete before proceeding. The default mode is 
rpc. 


Sub-elements: 

* An optional request description (cgha : request ) . When it is defined, this element specifies 
the parameters sent from the caller to the callee. 

* An optional reply description (cgha:reply). When it is defined, this element specifies the 
parameters replied by the callee to the caller. 

* An optional list of exceptions that can be raised (cgha:raise). 




B9 


cgha : parameter | 


name 


Specifies the identifier of the parameter. 


type 


Specifies the type of the parameter: simple type, structure type or enumeration 
type. For structures and enumerations, the type attribute specifies the fully 
qualified type name of that type. 


version 


Specifies the version of the parameter type (optional) 


array 


Specifies whether the parameter is an array. If the array attribute is set to 
"yes", the parameter is an array. The default value of this attribute is "no". 


Sub-elements : none 
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BIO 


cgha : structure 


type 


Specifies the identifier of the currently defined structure. 


version 


Specifies the optional version of the structure. 


Sub-element: 

* A list of members that defines the members of the structure (cgha : member). This list cannot 
be empty. 




|b11 cgha: member 


name 


Specifies the identifier of the member. 


type 


Specifies the type of the member, which can be either a simple type or one of the 
following types: structure ; enumeration ; object reference 
reference for all types which are not simple types. The type attribute is 
the fully qualified type name of that type . % 


version 


Specifies the version of the member type (optional) 


array 


Specifies whether the member is an array. If the array attribute is set to "yes 1 ', 
the member is an array. The default value of this attribute is "no". 


map 


Specifies whether a member of a structure is a map. If the map attribute is set 
to "yes", the member is a map. The default value of this attribute is "no". Note 
that the value of the map attribute must be set to "no" for members of ' 
exceptions and events. The type defined by the type and version attributes 
must have been previously defined. 




B12 


cgha : enumeration 


type 


Specifies the identifier of the currently defined enumeration. 


version 


Specifies the version of the enumeration (optional) 


Sub-element: none *' 




|B13 


cgha : enumValue 


name 


Specifies the identifier of the enumeration value. In the same enumeration it is 
not possible to have different enumeration values with the same identifier 
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|B13 


cgha : enumValue \ 


value 


Specifies the value of the enumeration value. It must be different from every 
other value in the same enumeration. If this attribute is not defined, the value of 
the enumeration value is generated automatically. 



B14 


cgha : ob j ectRef erence ~|j 


type 


Specifies the identifier of the object reference. 


version 


Specifies the version of the object reference. 


referencedObjectType 


Specifies the fully qualified type name of the object point- 
ed to by the reference. 


referencedObjectVersion 


Specifies the version of the referenced object. This attri- 
bute must be a positive integer. 


Sub-elements: none 



|B15 


cgha : reference 




type 


Specifies the identifier of the reference. 


Sub-element: none 



|B16 


cgha : raise 


type 


Specifies the fully qualified type name of the exception. If it is a structure or an 
enumeration, the type attribute is the fully qualified type name of that type 


version 


Specifies the version of the exception (optional). 


Sub-elements : none 



B17 


cgha : exception 


type 


Specifies the identifier of the currently defined exception. 


version 


Specifies the version of the exception (optional). 


Sub-element: 




* An optional list of members. This list defines the members of the exception 


(cgha : member ) . 
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B18 


cgha: publish j 


type 


Specifies the fully qualified type name of the event. 


version 


Specifies the version of the event. 




|B19 


cgha: event 


type 


Specifies the identifier of the event. 


version 


Specifies the version of the event. 


Sub-elements: 




* An optional list of members ( cgha : member). This list defines the members of the event 




CI 


cgha : component 


type 


Specifies the identifier of the currently defined component. 


version 


Specifies the version of the component. 


Sub-elements: 




* An optional list of interfaces used in the component, specified by means of cgha : use + 
elements. All the interface types that are used by the component must be included in this list ; 

* The component type configuration, defined using the cgha : type element. 

* An optional list of SAP definitions. 



C2 


cgha: use J 


type 


Specifies the fiilly qualified type name of the interface that is used by the 
component. This type must be an interface type. 


minVersion 


Specifies the oldest version of the interface that is used (this corresponds to 
the version with the lowest version number). 


maxVersion 


Specifies the most recent version of the interface that is used (this corres- 
ponds to the version with the highest version number). This attribute must 
be greater than or equal to the mi nVers ion attribute. 



C3 


cgha: type j 


No attribute 
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C3 



cgha : type 



Sub-elements: 

* An optional list of provided interfaces. The cgha : provide element defines the 
interfaces, including the versions that is used to define the component type configuration. It is 
only possible to provide interfaces without operations and with solely configuration attribu- 
tes. 

* A MIB. The cgha : mib element defines the MIB that is associated with the component 
type configuration. To be able to create objects implementing an interface in the MIB, the 
interface must be declared in the list of provided interfaces. If multiple versions of an 
interface are provided, the configuration is defined by the most recent interface (that is, the 
interface with the highest version number). 



|C4 


cgha: sap 


name 


Specifies the identifier of the SAP. 


scope 


Specifies the scope of the SAP with respect to the HA behavior of the 
component. The instance scope binds the SAP to the component instance life 
cycle. The assignment scope binds the SAP to the component assignment life 
cycle. 


access 


Specifies if the SAP is visible to the OMC through the Management Agent. This 
attribute can only take one of two values: management or cluster. If 
access is set to management, the SAP is visible to the OMC. If access is 
set to cluster, the SAP is not visible to the OMC. In both cases, the SAP is 
visible within the cluster. 


Sub-elements: 

* An optional list of provided interfaces. The cgha : provide element defines the interface, 
including the versions that are provided through the currently defined SAP. 

* An optional MIB. The cgha : mib element defines the MIB that is associated with the SAP. 
To be able to create objects implementing an interface in the MIB, the interface must be declared 
in the list of provided interfaces. If multiple versions of an interface are provided, the object 
implementing this interface must support all these versions. However, if multiple versions of an 
interface are provided, the configuration is defined by the most recent interface (the interface 
with the highest version number). 
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C5 


cgha: provide 


type 


Specifies the fully qualified type name of the interface. This type must be 
an interface type. 


minVersion 


Specifies the oldest version of the interface that is used (this corresponds 
to the version with the lowest version number). 


maxVersion 


Specifies the most recent version of the interface that is used (this corres- 
ponds to the version with the highest version number). This attribute must 
be greater than or equal to the mi nVer s i on attribute. 


Sub-element: None 



C6 


cgha : mib 


No attribute 




Sub-elements: 

* An optional list of contexts or objects (cgha : context, cgha : object). 



C7 


cgha: context 


name 


Specifies the identifier of the naming context. 


map 


Specifies whether or not the element defines a map of contexts. If the attribute is 
set to "yes", the element defines a map of contexts. In this case, each context is 
identified in the map by a unique key. New instances can be created at runtime. 


Sub-element: 

* An optional list of contexts or objects (cgha : context, cgha : object). 




C8 


cgha: object [ 


name 


Specifies the identifier of the object. In a MIB contained in a SAP, it is possible 
to associate at most one unnamed object, which is an instance of a singleton 
interface. An unnamed object has no name attribute specified and must appear 
directly within the cgha : mib element, not within a contained 
cgha : context. Furthermore, it is not possible to have named objects that are ! 
instances of a singleton interface. In all other cases, the objects must be named. 
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|C8 


cgha : object 


type 


Specifies the fully qualified type name of the interface that the object imple- 
ments. This interface must be provided in the element containing the MIB. The 
configuration is defined by the most recent version provided, that is the version 
with the highest version number. 


map 


Specifies whether the element defines a map of objects. If the map attribute is 
set to "yes", the element defines a map of objects. In this case, each object is 
identified in the map by a unique key. New instances can be created at runtime. 


Sub-elements: 

* An optional list of init values (cgha : init). This list, when defined, specifies the value 
of the attributes of the interface implemented by the object. 

* An optional list of contexts or objects (cgha : context, cgha : object). This list, when 
defined, specifies the contexts and objects that are nested within the currently defined object 






|di 


cgha: softwareLoad ~j 


name 


Specifies the identifier of the software load. 


version 


Specifies the version of the software load. 


Sub-elements: ! 



* An optional list of imported files (using the cgha : import element). 

* A cluster configuration definition (using the cgha : cluster element). 



* An optional list of component loads (cgha : componentLoad). A component load identifies 
a component and supports initialization of configuration attributes of objects contained in the 
component type configuration MIB. This initialisation is used, for example, to select the packages 
that are required for a specific software load. A software load cannot contain two different 
versions of the same component type. 



|p2 


cgha: cluster | 


version 


Specifies the version of the cluster configuration definition. 
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D2 



cgha : cluster 



Sub-elements: 

* An optional list of provided interfaces. The cgha : provide element defines the interface, 
including the versions that are used to defined the cluster configuration. It is only possible to have 
interfaces without operations and with only configuration attributes ( configuration set to 
"yes"). 

* A MIB. The cgha :mib element defines the MIB that is associated with the cluster configura- 
tion. To be able to create objects implementing an interface in the MIB, the interface must be 
declared in the list of provided interfaces. The version of the interface used to instantiate objects 
in the MIB is the most recent version of the interface that is provided, that is the version with the 
highest version number. 



D3 


cgha : componentLoad j 


type 


Specifies the fully qualified type name of the component. 


version 


Specifies the version of the component. 


Sub-element: 

* An optional list of configuration values that, when defined using cgha : ini t, specify the 
values of the attributes of the objects that are configured. 



El cgha : conf igurat ionUpdate 

name Specifies the identifier of the configuration update. 

version Specifies the version of the configuration update. 

Sub-elements: 

* An optional list of imported files ( cgha : import). 

* The software load definition. The cgha : sof twareLoadDef inition element identifies 
the software load on which the configuration is applied. 

* The optional cluster configuration initialization (cgha : clusterConf igurat ion). 

* A list of component configuration information: 

- cgha : typeConf iguration 

- cgha : instanceConf iguration 

- cgha : assignmentConf iguration 

- cgha : removelnstance 

- cgha : removeAssignment 
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E2 


cgha: sof twareLoadDef inition 


name 


Specifies the identifier of the software load. 


version 


Specifies the version of the software load. 






E3 


cgha : clusterConf iguration | 




No attribute 




Sub-element: 

* An optional list of configuration values that, when defined using cgha : init, specify the 
values of the attributes of the objects that are configured. 








|E4 


cgha : typeConf iguration | 


type 


Specifies the fully qualified type name of the component that is initialized. This 
component type must be part of the associated software load. 


Sub-element: 

* An optional list of configuration values that, when defined using cgha : init, specify the 
values of the attributes of the objects that are configured. 






[E5 


cgha: instanceConf iguration 


name 


Specifies the identifier of the instance. 


type 


Specifies the fully qualified type name of the component that is initialized. This 
component type must be part of the associated software load. It is not necessary to 
specify the version of the component, because it is not possible to have multiple 
versions of the same component in a software load. 


Sub-elements: 

* An optional list of SAP configuration (using the cgha : sapConf iguration element). In 
an instance configuration, it is only possible to configure SAPs that have an instance scope 




|E6 


cgha : assignmentConf iguration 


name 


Specifies the identifier of the assignment. 


type 


Specifies the fully qualified type name of the component that is initialized. This 
component type must be part of the associated software load. ! 



5 





1er depot 




81 


E6 


| cgha : assignmentConf iguration | 


Sub-elements: 

* An optional list of SAP configuration (using the cgha : sapConf igurat ion element) 




|E7 


cgha : sapConf iguration I 


name 


Specifies the identifier of the SAP that is initialized. 


Sub-elements: 

* An optional list of configuration values that, when defined using cgha : init, specify the 
values of the attributes of the objects that are configured. J 



10 



|E8 


cgha : removelnstance 


name 


Specifies the identifier of the instance to be removed. 


Sub-element: none 

1 ^ ■ ^ ^ : 
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|E9 


cgha : removeAssignment | 


name 


Specifies the identifier of the assignment to be removed. 


Sub-element: none 



20 



If, 


cgha : platf ormUpdate 


name 


Specifies the identifier of the platform update. 


version 


Specifies the version of the platform update. 


configuration 


Specifies whether the platform update configuration is completely new 
configuration (the configuration attribute is set to load) or an 
update of the existing configuration (the configuration attribute is 
set to update). 
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Fl | cgha: plat formUpdate 

Sub-elements: 

* An optional list of imported files (cgha : import). 

* An optional cgha : currentLoadDef inition element, which identifies the current load 
that is part of the platform update. 

* An optional cgha : softwareLoadDef inition element, which identifies the software 
load that is part of the Platform Update. 

* An optional list of cgha : conf igurationUpdateDef inition elements which identify 
the configuration updates that are part of the platform update. 



F2 


cgha : currentLoadDef inition ~~ I 


version 


Specifies the version of the current load. 



|F3 


cgha : conf igurationUpdateDef inition ~~| 


name 


Specifies the identifier of the configuration update. 


version 


Specifies the version of the configuration update. 



|F4 


cgha : currentLoad 


version 


Specifies the version of the current load. 


platformUpdateName 


Specifies the identifier of the current platform update. 


platformUpdateVersion 


Specifies the version of the current platform update. 


sof twareLoadName 


Specifies the identifier of the current software load 


softwareLoadVersion 


Specifies the version of the current software load 
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F4 



| cgha : currentLoad 



Sub-elements 
* 



An optional list of imported flies, using the cgha : import element. These files contain the 
definition of the component types that are used in the current load and the definition of interfaces 
that are used in the cluster definition. 

* A specification of the version and update level of the cluster configuration of the current load 

(cgha : currentCluster). 

* An optional list specifying the type, the version and the update level of each component of the 
current load (cgha : currentType). 

* An optional list specifying the name, type and the update level of each instance of the current 
load (cgha: current Instance). 

* An optional list specifying the name, type and the update level of each assignment of the 
current load ( cgha : currentAssignment). 



F5 



version 



cgha : currentCluster 



Specifies the version of the cluster configuration definition. 



updateLevel 



Specifies the update level of the cluster configuration. 



Sub-elements: 

* An optional list of provided interfaces. The cgha : provide element defines the interface 
including the versions used to defined the cluster configuration. It is only possible to have 
interfaces without operations and with solely configuration attributes (configuration set to 
yes). 

* A MIB. The cgha : mib element defines the MIB that is associated with the cluster configura- 
tion. To be able to create objects implementing an interface in the MIB, the interface must be 
declared in the list of provided interfaces. The version of the interface used to instantiate objects 
in the MIB is the most recent version of the interface that is provided, that is the version with the 
highest version number. 



F6 


cgha : currentType 


type 


Specifies the fully qualified type name of the component. Each component type 
specified must have been previously defined and imported. 


version 


Specifies the version of the component. 


updateLevel | Specifies the update level of the component configuration 
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F6 | cgha : currentTy pe ~~ 

Sub-elements: 

* An optional list of cgha : init elements used to specify the intial values of attributes. 



|F7 


cgha : current Instance 


name 


Specifies the identifier of the instance. 


type 


Specifies the fully qualified type name of the component type associated 
with the instance. 


updateLevel 


| Specifies the update level of the instance configuration. 


Sub-element: 

* An optional list of SAP configuration (defined using the cgha : sapConf iguration 
element). 




|F8 


cgha : currentAssignment j 


name 


Specifies the identifier of the assignment. 


type 


Specifies the fully qualified type name of the component type associated with 
the assignment. 


updateLevel 


Specifies the update level of the assignment configuration. 


Sub-elements: 

* An optional list of SAP configuration (defined using the cgha : sapConf iguration 
element). 



Table Eh2-1 



Identif . 


ELEMENT 


versionMin 


versionMax 


C2 


cgha: use 


Requ. 


Requ. 


C5 


cgha: provide 


Requ . 


Requ . 



Table Eh2-2 



Identif. 


ELEMENT 


Version 


UpdateLevel 


Bl 


cgha : interface 


Required 




B2 


cgha: inherit 


Required 
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cgha: attribute 



Optional 



cgha : parameter 



Optional 



cgha : structure 



cgha : member 



Optional 



Optional 



cgha : enumeration 



Optional 



cgha : ob j ectRef erence 



Required 



cgha : raise 



Optional 



cgha : exception 



cgha :publish 



cgha : event 



Optional 



Required 



Required 



cgha : component 



cgha : sof twareLoad 



Required 



Required 



cgha: cluster 



Required 



cgha : componentLoad 



Required 



cgha : conf igurationUpdate 



cgha : sof twareLoadDef inition 



Required 



Required 



cgha : plat formupdate 



Required 



Required 



cgha : currentLoadDef inition 



Required 



Required 



cgha : conf igurationUpdateDef inition 



Required 



Required 



cgha : currentLoad 



Required 



cgha: currentCluster 



Required 



Required 



Required 



cgha : currentType 



Required 



cgha : currentlnstance 



cgha: currentAssignment 



Required 



Required 



Required 
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Exhibit Eh3 - Description of CGHA-ML 

CGHA-ML is an example of an XML-based operational modeling language. 
Eh3.0-XML 

Generally, the XML syntax is defined in the XML specification available from W3C at 
http://www.w3.org/TR. The basic markup principle of XML is as follows: 

- consider the character string "TITLE" (hereinafter termed an identifier), 

- in an corresponding XML document, what is between "<TITLE>" and "</TITLE>" is an 
"element", 

- other data may be used to define what an element like "<TITLE>" may contain (including other 
nested elements, also called "sub-elements"), what attributes it may have. These other data may be 
separate, i.e. contained in a Document Type Definition (DTD), or have other formats, e.g. the one 
known as "XML schemas". 

In XML, a DTD follows the same markup principle as XML itself, however with slightly different 
syntax rules, and reserved words like #PCDATA. The DTD expressions are enclosed between 
"<!XXXXX" and ">", where "XXXXX" is a DTD keyword, e.g. "ELEMENT", and the rest is a 
name, followed with one or more other arguments or "sub-elements". The expressions are case- 
sensitive. The DTD provides a formal definition of the elements with <!ELEMENT >. Each 

ELEMENT may also have attributes, defined with the syntax <! ATTLIST >). This defines the 

relationship among the data elements. An <!ENTITY # ..... > clause may be used to build a 
parameter entity for internal use in the DTD. Finally, comments are enclosed between "<[--" and 
>" markups. 

Thus, the syntax of all elements of an OMSL may be defined in a DTD, a detailed example of which 
appears in Exhibit Eh 1 . 

The main features of the exemplary DTD of will now be commented. 

The labels added in the left column for each identifier of Exhibit Ehl are used in this description 
and in the tables of Exhibit Eh2. 
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It will be appreciated that, in a DTD, many elements are interrelated, and may not be commented 
in all occurrences. 

Eh3.1 - Generic constructs 



The exemplary document type definition or DTD has generic constructs, used in common to all 
models. 



Elements are characterized by an identifier. An identifier is a string of characters, which should be 
formed in accordance with specific rules (including naming rules). The identifiers of the DTD will 
now be considered jn more detail. 

At A 1, the DTD has a cgha : description element, which may be used to provide a plain text 
description of the element in which it is located. Many elements in the DTD may have an optional 
description using cgha : description a sub-element. This will not be further commented. 

An OMSL may be organized in independent documents, implemented as files in an underlying file 
system. t 

At label B5, the DTD has a cgha : ihit element which may be used to specify the initial values 
of attributes. The cgha : init element may also contain an optional list of other cgha Unit 
elements; the list of initialization elements may be Used to navigate into the contents of a "plural" 
entity, for example to initialize the members of a structure. 

s/ 

The usage of cgha : init , i.e. the initialization, may be done at multiple levels: interface 
definition level, component definition level, software load definition level, configuration update 
definition level. By default ( final attribute set to "no"), it is possible to later Overwrite the 
initialization. Setting final to yes at a given level in the sequence of processing : interface 
definition level/component definition level/software load definition level/configuration update 
definition level will prohibit later overwriting. Such a scheme builds a hierarchy of initializations. 
For example, a default value might be assigned to an attribute in the definition of the interface. This 
value might be overwritten in the definition of the component providing the interface, and this value 
might finally be updated in the configuration. If the final attribute is set to "yes", the value 
cannot be overwritten thereafter. 
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An OMSL may provide defined types, which may be organized in packages, e.g. simple types and 
also new types. Simple types may include all or part of the usual "system" types of software entities, 
e.g. Boolean, Byte, Short, Int, Long, Float, Double, String, UnsignedByte, UnsignedShort, 
Unsignedlnt, UnsignedLong. 

These simple types may further be used in plural types, here: 

- structure (B 1 0), having members (B 1 1 ) ; 

- enumeration^ 12), having values called enumValues (B13). 

* Interface, used to specify services and managed objects provided by a component; e.g. 

cgha : interface 

* object reference, used to define references to objects, e.g. cgha : ob j ectRef erence 

Reference, used to define references to component instances or assignments, e.g. 
cgha : reference 

* Exception, used to specify exceptions that can be raised during invocations of operations, e.g. 
cgha : exception 

* Event, used to specify events in the OMSL, that are published by the software (platform arid 
applications) running on the network element, e.g. cgha : event 

Component, used to specify a component that is deployed on the platform, e.g. 
cgha : component 

Each defined type is characterized by its type identifier and by the sub-elements it contains. The 
type identifier is defined by the type attribute of the element, and may be formed in accordance 
with specific naming rules. The exemplary DTD supports a single namespace for defined types. 
Thus, parsers may be used to check that type identifiers are unique within a software load model, 
that is, that no type definition overwrites another type definition. 

When it is necessary to refer to a type from within another package, a fully qualified type name may 
be used, e.g. in the form of a concatenation of the package identifier and the type identifier. 

The types may contain nested sub-elements, e.g. as defined in the exemplary DTD, while 
distinguishing whether these are optional, or required. 

Types of an OMSL may be defined in a package e.g. by means of the cgha : package element, 
which appears at A3 in the DTD. Thus, a given cgha : package is related to its own set of type 
definitions. In the exemplary CGHA-ML, the set comprises the following type definitions: 
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cgha:interface, cgha: structure, cgha: ob j ec t Reference , 

cgha: reference, cgha : enumeration, cgha : exception, cgha : event, 
cgha : component. 

Each cgha : package may be specified as an independent file that may not contain anything other 
than that cgha: package element. The same package may be defined in more than one 
cgha: package element. The package is made up of all the types defined in all the 
cgha : package elements with that package name. Every type in a given package must have a 
different name (identifier) from every other type in the package. 

Eh3.2 - Interface Model 

The interface model of the OMSL will now be described, with the exemplary syntax and semantics 
of each element which may be used in it. 

The cgha : interface element (at Bl in the DTD) may be used to specify the functionality 
provided by a component and to define the types of the objects that are instantiated in MEBs 
(Management Information Bases). 

An OMSL may allow interfaces to be specialized, using inheritance, in order to add functionality. 
The cgha : inherit element (B2) may be used to designate a base interface, if any, that the 
currently specified interface (then called the derived interface) inherits from. The ancestors of a 
derived interface are its base interface and the ancestors of that base interface. Only single 
inheritance is supported in the exemplary embodiment. 

The cgha : constant element (B3) is used to define constants in the scope of an interface. 

The cgha : attribute element (B4) defines the attributes that are part of an interface. An 
attribute is a field of the interface that holds data values. In the exemplary embodiment, versioning 
is supported at the interface definition level. It may be supported at the attribute definition level as 
well. 

The cgha: operation element (B6) defines the operations that are part of an interface 
specification. Several possibilities exist: 
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- in the example, a oneway operation should not contain a reply description. It is also possible 
to define a oneway operation that contains no request parameters. 

- it is possible to define an rpc operation that contains reply parameters without having request 
parameters. It is also possible to define an rpc operation that contains no request parameters and 
no reply parameters. 

- exceptions can be triggered in order to provide out-of-band error support. 

The cgha : request element (B7) defines the request part of an operation. It may contain a list 
of one or more parameters (.cgha: parameter ; B9). This list, when defined, specifies the 
parameters associated with the request. 

The cgha : reply element (B8) defines the reply part of an operation. It contains a list of one or 
more parameters ( cgha : parameter ; B9), which specifies the parameters associated with the 
reply. 

Thecgha: structure element (B 1 0) is used to define structures. The cgha : member element 
<B1 1) may be used to specify the members of structures, events and exceptions. 

The cgha : enumeration element (B12) is used to specify an enumeration type. Itmay contain 
a list of enumeration values, which specifies the possible values of the enumeration. Each member 
of the list may be specified using the cgha : enumValue element (B13). In the example, the 
values associated with an enumeration are of type Int. 

The cgha : obj ectReference element (B14) is used to define references to objects. In the 
example: 

- the data related to a cgha : ob jectRef erence element may be initialized by means of the 

cgha.-init element, with the reference attribute of the cgha : i nit element being set to 

object. 

- an object reference may be used as a type of a configuration attribute, only when 
configuration issetto »yes«.Thus, thecgha : obj ectReference element only support, 
references to objects that are in the same MB as that containing the cgha : obj ectReference 
element itself 



:s 
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Thecgha : reference element (B 15) is used to define simple references to component instances 
or assignments. (In the examples, the references are dot-separated names; however, LDAP-like 
references may be used as well. 

In the example: 

- data related to a cgha : reference element may be initialized using the cgha : init element. 

- if the referenced component is an instance, the reference attribute of the cgha: init 
element may be set to instance. 

r if the referenced component is an assignment, the reference attribute of the cgha : init 
element is set to assignment. 

- a reference may be used as a type of a configuration attribute only when configura- 
tion is set to "yes". 

For both the objectRef erence and the reference , dot-separated names are used in the 
example; however, other notations may be used as well, e.g. LDAP-like references. 

The cgha : raise element (B 16) should be used to specify the exceptions that might be raised 
during the invocation of an operation. The cgha : exception element (B17) is used to define 
an exception that can be generated during the invocation of an operation. 

The cgha:publish element (BIS) is used to specify the events that might be published by 
objects implementing the currently defined interface. 

The cgha : event element (B19) may be used to specify the events that are handled by the 
network element software using the event mechanism of the underlying Software Platform. For 
members Of events, the value of the map attribute should be set to "no". ; 

Eh3.3 - Component Mode? 

The Component model of the OMSL will now be described, with the exemplary syntax and 
semantics of each element which may be used in it. 



The cgha : component element (CI in the DTD) may be used to define a component type. This 
definition may include the interfaces that are provided or used by the component, the events that are 
published by the component and the MIBs of the component. 
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The component type configuration is initialized to the proper values and partially finalized in order 
to avoid later overwriting. In the example, up to four SAPs {Service Access Points)may be defined 
in the component: 

* an instanceManagement SAP providing access to component instance management. 
*an assignmentManagement SAP providing access to component assignment management. 

* a log SAP providing log services. 

* a control SAP providing control of the log manager. 

The cgha : us e element (C2) may be used to declare the versions of an interface that are used by 
a component. The cgha : type element (C3) may be used to define a component type 
configuration. The cgha : sap element (C4) may be used to define a service access point (SAP) 
in a component. The cgha : provide element (C5) may be used to declare the versions of an 
interface that are provided through a SAP. 

The cgharmib element (C6) defines a hierarchical naming tree describing the containment 
hierarchy of objects. It consists of a number of objects associated with the leaves and nexus of the 
naming tree. The cgha : mib element is used to define the MIB associated with its container. In 
the example, the cgha: mib element should always be contained within one of the following 
elements: cgha : sap, cgha : type, cgha : cluster 

In the example, the name space provided by the MIB is local to its container (a SAP if the MIB is 
associated with a SAP, a component type if the MIB is associated with a component type, a cluster 
if the MIB is associated with the cluster). This means that the MIB itself does not need to be 
identified, and therefore does not have a name attribute. Each object is uniquely defined in a MIB 
by its full name, which describes the location of the object in the name space of the MIB. In other 
words, the MIB may provide the root of the naming context. 

The cgha : context element (C7) is used to define a new naming context in the MIB. The period 
character ( .) may be used as the separator to concatenate names of the naming context tree into a 
single full name inside a MIB. In a given naming context, two different items (context or object) 
should not have the same identifier. 

The cgha : ob j ect element (C8) is used to declare an object inside a specific naming context of 
a MIB. Each object instantiates an already defined interface. The period character (.) is used as the 

(V 
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separator to concatenate the full name of the naming context and the name of the object in order to 
obtain the full name of the object inside the MIR 

Eh3.4 - Software Load Model 

The Software Load model of the OMSL will now be described, with the exemplary syntax and 
semantics of each element which may be used in it. 

The cgha : softwareLoad element (DI) is used to specify a software load. In the exemplary 
embodiment, each cgha : softwareLoad element should be specified in an independent file. 

The cgha : cluster element (D2) may be used to define the cluster configuration MIB. 

The cgha : componen tLoad element (D3) may be used to identify the components that are part 
of the software load . It supports initialization of configuration attributes of objects contained in the 
component type configuration MIB. This initialization may be used, for example, to select the OS 
(e.g. Solaris) packages that are required for a specific software load. The parser of the OMSL should 
ensure the consistency between the initialization clauses and the MIB. 

Eh3.5 - Configuration Update Model 

The cgha : conf igurationUpdate element (El) is used to specify a configuration update. 
Each such element should be specified in an independent file. 

When creating an instance or an assignment, the instance configuration or the assignment 
configuration should be used. The instance or assignment is referred to in the cluster configuration 
MIB. 

The cgha : so f twareLoadDe finition element (E2) may be used to specify the software load 
configured in the configuration update or platform update. 

The cgha : clusterConf iguration element (E3) may be used to initialize configuration 
attributes of objects contained in the cluster configuration MIB. The parser should ensure the 
consistency between the initialization clauses and the MIB. 

(X 
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The cgha: typeConf iguration element (E4) may be used to initialize configuration 
attributes of objects contained in the component type configuration MIB. The parser should ensure 
the consistency between the initialization clauses and the MIB. 

The cgha : instanceConf iguration element (E5) may be used to configure an instance of 
a component. 

The cgha : assignmentConf iguration element (E6) may be used to configure an 
assignment. In an assignment configuration, it is only possible to configure SAPs that have an 
assignment scope. 

The cgha : s apConf iguration element (E7) may be used to initialize configuration attributes 
in the MIB associated with the SAP. The parser should ensure the consistency between the 
initialization clauses and the MIB. 

The cgha : remove Instance element (E8) may be used to remove an instance that has been 
created previously. The cgha : removeAssignment element (E9) may be used to remove an 
assignment that has been created previously. 

Eh3.6 - Platform Update Model 

The cgha : plat f ormUpdate element (Fl ) may be used to specify a platform update. Each such 
element must be specified in an independent file. The software load defined in each configuration 
update should be the same as that defined in the platform update. 

The OMSL parser may check that all attributes with a configuration attribute set to " yes " 
are initialized. The granularity of the configuration update may be the MIB. This means that if a 
MIB is created or modified, all the configuration attributes of that MIB must be initialized in one 
or more cgha : conf igurationUpdate elements. As indicated, a MIB can be created or 
modified, using the instanceConf iguration, assignmentConf iguration, type- 
Configuration or clusterConf iguration elements. 

Therefore in the case of an update of an existing configuration (configuration attribute set 
to update), all the configuration attributes of all the MIBs that have been updated must be 
initialized. 
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In the case of a completely new configuration ( configuration attribute set to load), all the 
configuration attributes of all the MlBs that are defined in the software load should be initialized. 
These MIBs are the instance MIBs, the assignment MIBs, the component type configuration MIBs, 
and the cluster configuration MTB. 

The cgha : currentLoadDef inition element (F2) may be used to specify the current load 
that is used in the platform update. 

The cgha: conf igurationUpdateDef inition element (F3) may be used to specify the 
configuration update that is used in the platform update. 



The elements labelled F4, F5, F6, F7, F8 are be generated by the Software Factory toolchain for its 
own use: 

- The cgha : currentLoad element (F4) may be used to specify in an independent file the 
current load of a Network Element : component types, component instances, component 
assignments, and the cluster definition. 

- The cgha : currentClus ter element (F5) maybe used to specify the version and the update 
level of cluster configuration. 

- The cgha:currentType element (F6) may be used to configure the component type 
configuration MTB. 

- The cgha : current Ins tance element (F7) may be used to specify each instance of a current 
load. The cgha : currentlnstance 

- The cgha : currentAssignment element (F8) may be used to specify each assignment of a 
current load. 
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Exhibit Eh4 - Exemplary CGHA-ML code 



Eh4 - 1 - attributes of the ComponentDescriptor interface 

<cgha: package name= "com. sun . cgha . types "> 
<cgha: interface type= "ComponentDescriptor" version="l"> 
<cgha : attribute name~"componentCategory" 
type="com. sun. cgha. types .ComponentCategory" 
mode="R" configuration="yes" /> 
<cgha: attribute name="availabilityDescriptor " 
type="com. sun. cgha . types .AvailabilityDescriptor " 
mode="R n configuration="yes" /> 
<cgha : attribute name="packagingDescriptor" 
type="com. sun . cgha . types . PackagingDescriptor" 
array="yes" mode="R" conf iguration="yes" /> 
1 5 </cgha : inter f ace> 

</cgha :package> 
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Eh4-2 : 

<cgha .-enumeration type="ComponentCategory"> 
<cgha:enumValue name= "PROXY" value- "0" /> 
<cgha : enumValue name^'PROXIED" value="l" /> 
<cgha:enumValue name=" STANDALONE" value="2" /> 
</ cgha : enumeration> 



25 Eh4-3 



<cgha : enumeration type="RedundancyModel"> 
<cgha : enumValue name= M HOT_RESTART" value="0" /> 
<cgha : enumValue name="NON_HA" value="l" /> 
<cgha : enumValue name="HA_2N" value="2" /> 
< cgha : enumValue name="HA_N_PLUS_l" value="3" /> 
</cgha :enumeration> 



Eh4-4 

<cgha : structure type="AvailabilityDescriptor"> 

<cgha imember name="redundancyModel " 

type="com. sun . cgha . types . Re dundancyModel" /> 

<cgha:member name="restartable" type="Boolean" /> 

<cgha: member name="switchOverEscalationCount " type="Int" /> 

<cgha:member name="switchOverEscalationrimewindow" type="Int" /> 

<cgha:member name="crimRequestResponseTimeOut " type="Int" /> 

</cgha : structure> 



Eh4-5 

<cgha : structure type="CreationDescriptor"> 
<cgha:member name="timeOut " type="Int" /> 
<cgha:member name="binaryPath" type="String" /> 
<cgha:member name=" terminationTimeOut " type="lnt" /> 
<cgha:member name="userld" type="Long" /> 
<cgha : member name="groupId" type="Long" /> 
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</cgha : structure> 

Eh4-6 

<cgha : enumeration type="PackageType"> 
5 <cgha:enumValue name= *' DOCUMENT AT I ON " value="0" /> 

<cgha:enumValue name = "DEVELOPMENT M value="l" /> 
<cgha:enumValue name= n RUNTIME" value="2" /> 
</cgha : enumeration> 

<cgha : structure type= M PackagingDescriptor "> 
10 <cgha :member name= "plat form" type-="String" /> 

<cgha:member name="os" type="String" /> 

<cgha:member name="type" type= "com. sun . cgha . types . PackageType" /> 
<cgha:member name="packageNames" type="String" array="yes" /> 
</cgha : structure 
15 <cgha: structure type="DeploymentDescriptor"> 

<cgha:member name="platf orm" type="String" /> 
< cgha : member name="os" type="String" /> 
</cgha : structure> 

20 Eh4-10 

<cgha :package name=" com. sun. cgha. types" 
xmlns : cgha="http : //www . sun . com/CGHA"> 

<cgha: import href="/com/sun/cgha/types/ComponentDescriptor . 1 . xml" /> 
<cgha : interface type="Sof twareComponentDescriptor" version="l"> 
^5 <cgha : inherit type="com. sun . cgha .types . Component Descriptor" 

version="l" /> 

<cgha : attribute name= n creationDescriptor" 
type="com. sun . cgha . types . CreationDescriptor " 
mode="R" configuration="yes"> 
<cgha:init member="userld" value="0" /> 
<cgha:init member=" group Id" value="0" /> 
</cgha : attribute> 

<cgha ; attribute name="deploymentDescriptor" 
type="com. sun. cgha. types. DeploymentDescriptor" 
array="yes" mode="R" conf iguration="yes" /> 
</cgha: interfaced 
</cgha:package> 
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Eh4-ll 

<cgha:package name="com. sun. cgha . types" 
xmlns :cgha="ht tp:/ /www. sun.com/CGHA"> 

<cgha : import href =" / com/sun/cgha/types/ComponentDescriptor . 1 . xml " /> 
<cgha: inter face type="HardwareComponentDescriptor" versiori="l"> 
<cgha: inherit type="com. sun .cgha .types .ComponentDescriptor" 
version="l" /> 
</cgha: inter face> 
< /cgha : package > 



Eh4-20 
50 Eh4-20-A 
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<! --Component type description — > 
<cgha : import 

href=" /com/sun/cgha/types/Sof twareComponentDescriptor . 1 .xml" /> 
<cgha : component type="Sof twareComponentExample" version="l"> 
<cgha : description> 

</cgha : description> 
<cgha: type> 

<cgha : provide type="com. sun.cgha . types . SoftwareComponentDescript- 
minVersion="l" maxVersion=" 1" /> 



Eh4-20-B 

<cgha :mib> 

<cgha : obj ect name="componentDescriptor" 

type="com. sun. cgha . types . Sof twareComponentDescriptor M > 

, . . (initialization) 

Eh4-20-C 

<cgha : init attribute="componentCategory" 
value— "STANDALONE" f inal="yes" /> 

Eh4-20-D 

<cgha:init attribute="availabilityDescriptor" final="yes"> 
<cgha:init member="redundancyModel" value="HA_2N" /> 
<cgha:init member="restartable " value=" FALSE" /> 
<cgha:init member="switchOverEscalationCount" value="0" /> 
<cgha:init member="switchOverEscalationTimeWindow" value="l" /> 
<cgha:init member^'crimRequestResponseTimeOut" value="l" /> 
</cgha:init> 



Eh4-20-E 

<cgha:init attribute="creationDescriptor" f inal="yes* T > 
<cgha:init member=" time Out" value="l" /> 
<cgha:init member= H binaryPath , • value-"..." /> 
<cgha:init member="terminationTimeOut" value="l" /> 
<cgha:init member="userld" value="106573" /> 
<cgha:init member="groupId" value="55" /> 
</cgha:init> 



Eh4-20-F 

<cgha : init attribute="packagingDescriptor"> 
<cgha:init key="0"> 

<cgha:init member="platf orm" value= "common" /> 
<cgha:init member="os" value=" common" /> 
<cgha:init member=" type" va 1 ue= " RUNT I ME " /> 
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<cgha:init membe r= "pac ka g eName s " > 

<cgha:init key«"0" value="PKGCOMl M /> 

</cgha:init> 

</cgha:init> 

<cgha:init key="l"> 

<cgha:init meraber= "platform" value= "SPARC n /> 
<cgha:init member ="os M value="Solaris" /> 
<cgha:init membe r=" type" value="RUNTIME" /> 
<cgha : init member=" pac kag eName s "> 
<cgha:init key="0" value="PKGSOLl" /> 
<cgha:init key="l" value="PKGSOL2" /> 
</cgha:init> 
</cgha : init> 
<cgha:init key="2"> 

<cgha:init member^ "plat form" value="SPARC" /> 
<cgha:init member="os" value="ChorusOS " /> 
<cgha:init member="type" value= "RUNTIME" /> 
<cgha:init member="packageNarnes"> 
<cgha:init key="0" value="PKGCH01 " /> 
<cgha:init key="l" value="PKGCH02" /> 
</cgha: init> 
</cgha : init> 
</cgha :init> 

Eh4-21 - How to Use the instanceManagement SAP 

<cgha:sap name="instanceManagement " scope="instance"> 
<cgha:description> 

This SAP gives access to the mandatory MIB that 
must be associated with each component instance. 
</cgha : description 

<cgha :provide type="com. sun . cgha . types .management . Instance" 

minVersion="l". maxVersion= M l" /> 

<cgha:mib> 

<cgha : ob j ect type="com. sun . cgha . types .management . Instanced 

</cgha : ob j ect> 

</cgha :mib> 

</cgha: sap> 

</cgha : component > 

</cgha :package> 

Eh4-30 

<cgha: package name= "com. sun . cgha . types .management " 
xmlns : cgha="http : //www . sun . com/CGHA"> 

<cgha: enumeration type*="UsageState"> 
<cgha : enumValue name="IDLE" value="0" /> 
< cgha : enumValue name= "ACTIVE" value="i" /> 
<cgha: enumValue name="BUSY" value="2" /> 
</cgha : enumeration> 

<cgha: interface typ.e= "Assignment" version="l" singleton="yes" 
<cgha: attribute name="usage" 

type="com. sun . cgha . types . management . Usages tate " 
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mode="R" /> 
</cgha : interf ace> 

</cgha :package> 

Eh4-3 1 - How to use the assignmentManagement SAP 
<! --Generic management types — > 

<cgha: import href =" /com/sun/cgha/ types /management /Assignment . 1 . xml " 
<cgha: component type-"Sof twareComponent Example" version="l M > 

<cgha:sap name= "assignmentManagement" scope="assignment "> 
<cgha : description> 

This SAP provides access to the MO associated with assignments. 
</cgha : description> 

<cgha : provide type="com. sun . cgha . types .management . Assignment" 

minVersion="l" raaxVersion="l" /> 

<cgha:mib> 

<cgha : object type="com . sun . cgha . types .Assignment "> 

<cgha : description> 

The usage state of a component. 

</cgha : description> 

</cgha : object> 

</cgha:mib> 

</cgha : sap> 

</ cgha : component> 
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Exhibit Eh5 - Tables related to the MIBs and SAPs 
TABLE Eh5-1 The Component Type Configuration MIB 



5 



Mandatory object name 


componentDe script or 


Related object type 


com . sun . cgha . types . Component Soft war eDescriptor 
or 

com . sun . cgha . types . Component HardwareDescriptor 
Both of these types inherit from: 

com. sun . cgha . types . ComponentDescriptor 


Attributes (and type) 


com. sun. cgha. types. ComponentDescriptor: 

v« viii^u«4c 1 1 v> v»u u \j i~ y i en urn type i. 

* availabilityDescriptor (structure). 

packagingDescriptor (array of structures) . 
com. sun . cgha .types . Sof twareComponent Descriptor: 
cr eat ion De scrip tor (structure). 

* deploymentDescriptor (array of structures) . 

com. sun . cgha . types . HardwareComponent Descriptor: 

* No specific attributes found. 



TABLE Eh5-2 The instanceManagement SAP and its MIB 
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15 



Mandatory object name 


(None: singleton interface) 


Related object type 


com. sun. cgha. types .management .Instance 


Attributes (and type) 


(optional) 


Corresponding mandatory SAP 


instanceManagement 


TABLE Eh5-3 The assignmentManagement SAP and its MIB 


Mandatory object name 


(None: singleton interface) 


Related object type 


com. sun. cgha . types . management . Assignment , 


Attributes (and type) 


usage (enumtype). 

This is runtime information exposed to remote clients. 


Corresponding mandatory SAP 


assignmentManagement 



20 

TABLE Eh5-4 Attributes of the ComponentDe scriptor interface Type 

| Attribute | Description 




OC 
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component Category 


Provides configuration type information required by the CRIM. 


availability Descriptor 


Provides availability information required by the CRIM: 

* The redundancy model of the component. 

* The switch-over escalation count and time window. 

* The time out for a component to respond to a CRIM request. 

* Definition of whether the component is restartable or not. 


packagingDescriptor 


Provides packaging description required by the SLBT 
(via the ml2swload tool). 



1 er depot 



103 

Exhibit Eh6 - Mapping from CGHA-ML - Exemplary tables 

TABLE Eh6-1 Mapping CGHA-ML Name Tokens to Java MBeans 



CGHA-ML Construct 


CGHA-ML Identifier 


Mapping to Java MBeans 


Package 


thispackage 


com . sun . thispackage 


Type 


ThisClass 


ThisClass 


Operation 


thisMethod 


thisMethod 


(Generated return type) 




ThisClass . ThisMethodReply 


Attribute with read access 


thisAt tribute 


getThisAt tribute 


Attribute with write access 


thisAt tribute 


setThisAttribute 


Constant 


THIS_CONSTANT 


THIS_CONSTANT 


Enumeration value 


ENUM_JVALUE 


ENUM_VALUE 


TABLE Eh6-2 Mapping CGHA-ML Name Tokens to RPC and C 


CGHA-ML Construct 


CGHA-ML Identifier 


Mapping to RPC and C 


Package 


thispackage 


(not mapped) 


Type 


ThisClass 


this_class (prefix) 


Operation 


thisMethod 


this_class_this_method 


(Generated return type) 




this_class__this_method_reply 


Attribute with read access 


thisAt tribute 


this_class_get_jthis_at tribute 


Attribute with write access 


thisAt tribute 


this_class_set_this^attribute 


Constant 


THIS_CONSTANT 


TH I S__CONSTANT 


Enumeration value 


ENUM_VALUE 


ENUM_ VALUE 



TABLE Eh6-3 Mapping CGHA-ML Name Tokens to LDAP 



CGHA-ML Construct 


CGHA-ML Identifier 


Mapping to LDAP 


Package 


thispackage 


com-sun-thispackage * 


Type 


ThisClass 


corn-sun- this-package-ThisClass 


Attribute 


thisAttr 


com-sun-this-package-ThisClass-n- thisAt tr (*) 



(*) n is the version number 
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Exhibit Eh7 

Eh7-0 - LDAP layout 

software load <— software load definition 
version 

dn 

platform update <-- platform update definition 
version 

table 

cluster < — cluster configuration 
version 

update level 
mib 

types 

component type < — component type configuration 
version 

update level 
mib 

instances 

component instance <— component instance configuration 
sap 

version 

update level 
mib 

assignments 

component assignment <— component assignment configuration 
sap 

version 

update level 
mib 



Eh7- O - LDAP object classes 
Eh7-01 (cgha-attribute-oc) 

dn: cn= schema 
changetype: modify 
add: attributetypes 

attributetypes: { cgha-attribute-name-oid 
NAME 'cgha-attribute-name' 

SYNTAX 1-3.6.1.4.1.1466.115.121.1.15 # Directory Stri: 
S INGLE-VALUE ) 
dn : cn=schema 
changetype: modify 
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add: objectclasses 

objectclasses: ( cgha-attribute — oc-oid 
NAME 'cgha-attribute — oc' 
SUP top 

MUST ( cgha-attribute-name ) ) 



Eh7-02 (cgha-member-oc) 

dn: cn=schema 
changetype: modify 
add: attributetypes 

attributetypes: ( cgha-member-name-oid 

NAME ' cgha -member -name' 

SYNTAX 1.3.6.1.4.1.14 66.115.121.1.15 

SINGLE-VALUE ) 

dn: cn= schema 

changetype: modify 

add: objectclasses 

objectclasses: ( cgha -member — oc-oid 
NAME ' cgha -member — oc' 
SUP top • 

MUST ( cgha-member-name } ) 

Eh7r03 (cgha-element-oc) 

dn: cn=s enema 
changetype: modify 
add: attributetypes 
attributetypes: ( cgha-key-oid 
NAME 'cgha -key' 

SYNTAX 1.3. 6'. 1.4. 1.1466. 115. 121. -1.15 
SINGLE- VALUE ) 
dn: cn= schema 
changetype: modify . 
add: objectclasses 

objectclasses: ( cgha-element — oc-oid 
NAME 'cgha-element — oc' 
SUP top MUST ( cgha-key ) ) 



Eh7-04 (cgha-structure--oc) 

dn: cn=schema 
changetype: modify 
add: attributetypes 

attributetypes: ( cgha-structure-type-oid 
NAME ' cgha-structure-type' 

SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 # IAS String 

SINGLE-VALUE) 

dn: cn-schema 

changetype: modify 

add: attributetypes 

attributetypes: ( cgha-structure-version-oid 
NAME 'cgha-structure-version' 

SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 # IAS String 
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SINGLE-VALUE > 
dn : cn= schema 
changetype: modify 
add: objectclasses 

objectclasses : ( cgha-structure — oc-oid 
NAME 'cgha-structure — oc' 
SUP top 

MUST ( cgha-structure-type ) 
MAY ( cgha-structure-version ) ) 

Eh7-05 (cgha-object-reference--oc) 

dn: cn=s enema 
changetype: modify 
add: attributetypes 

attributetypes : ( cgha-ob ject-ref erence-type-oid 
NAME ' cgha-object-ref erence-type' 

SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 # IA5 String 
SINGLE-VALUE ) 
dn: cn=schema 
changetype: modify 
add: attributetypes 

attributetypes: ( cgha-ob ject-ref erence-version-oid 

NAME ' cgha-ob ject-ref erence-version' 

SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 # IAS String 

SINGLE- VALUE ) 

dn: cn= schema 

changetype: modify 

add: attributetypes 

attributetypes: ( cgha-object-ref erence-mib-dn-oid 

NAME ' cgha-ob ject-ref erence-mib-dn' 

SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 # IA5 String 

SINGLE-VALUE ) 

dn : cn= schema 

changetype: modify 

add: attributetypes 

attributetypes: { cgha-obj ect-ref erence-f ull-name-oid 

NAME ' cgha-object-ref erence-f ull-name' 

SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 # IAS String 

SINGLE-VALUE) 

dn: cn= schema 

change t ype : modi f y 

add: objectclasses 

objectclasses: ( cgha-obj ect-ref erence — oc-oid 
NAME 9 cgha-object-ref erence — oc' 
SUP top 

MUST ( cgha-obj ect-ref erence-type . $ 
cgha-cgha-obj ect-ref erence-version $ 
cgha-cgha-ob ject-ref erence-mib-dn $ 
cgha-cgha-object-reference-full-name ) ) 



Eh7-06 (cgha-reference— oc) 

dn : cn=schema 
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changetype : modify 
add: attributetypes 

attributetypes: ( cgha-ref erence-type-oid 
NAME * cgha-reference-type' 

SYNTAX 1.3.6,1.4.1.1466.115.121.1.26 # IAS String 
SINGLE- VALUE ) 
dn: cn-schema 
changetype: modify 
add: attributetypes 

attributetypes: ( cgha-ref erence-dn-oid 
NAME ' cgha-ref erence-dn' 

SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 # IA5 String 
SINGLE-VALUE ) 
dn: cn=scheraa 
changetype: modify 
add: obj ectclasses 

objectclasses: ( cgha-ref erence— oc-oid 
NAME ' cgha-ref erence — oc' 
SUP top 

MUST ( cgha-reference-type $ 
cgha-reference-dn ) ) 

Eh7-07 (cgha-object-oc) 

dn: cn=schema 
changetype: modify 
add: attributetypes 

attributetypes: ( cgha-obj ect-name-oid 
NAME ' cgha -object -name' 

SYNTAX 1.3. 6'. 1.4. 1.1466. 115. 121. 1.15 # Directory String 
SINGLE-VALUE ) 
dn: cn-schema 
changetype: modify 
add: objectclasses 

objectclasses: ( cgha-object--oc-oid 
NAME 'cgha-object — oc' 
SUP top 

MUST ( cgha-object-nanie ) ) 



Eh7-08 (cgha-interface-oc) 

dn: cn=schema 
changetype: modify 
add: attributetypes 

attributetypes: ( cgha-interface-type-oid 
NAME ' cgha-interface-type' 

SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 # IA5 String 
SINGLE-VALUE ) 
dn: cn-schema 
changetype : modify 
add: attributetypes 
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attributetypes : ( cgha-interf ace-version-oid 
NAME ' cgha-interf ace-version' 

SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 # IA5 String 
SINGLE -VALUE ) 
dn; cn=schema 
changetype: modify 
add: obj ectclasses 

objectclasses : { cgha-interf ace — oc-oid 
NAME ' cgha-interf ace — oc' 
SUP top 

MUST < cgha-interface-type $ cgha-interf ace-version ) ) 

Eh7-09 (cgha-context— oc) 

dn: cn-schema 
changetype: modify 
add: attributetypes 

attributetypes: ( cgha-context-name-oid 
NAME ' cgha-context-name' 

SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 # Directory String 
SINGLE- VALUE ) 
dn: cn= schema 
changetype: modify 
add: objectclasses 

objectclasses: { cgha-context — oc-oid 
NAME 'cgha-context — oc' 
SUP top 

MUST ( cgha-context-name ) ) 

Eh7-01 0 (cgha-cluster-version-oc) 

dn: cn= schema 
changetype: modify 
add: attributetypes 

attributetypes: ( cgha-cluster-version-oid 
NAME ' cgha-cluster-version' 

SYNTAX 1.3.6.1.4.1.14 66.115.121.1.15 # Directory String 
SINGLE- VALUE ) 
dn: cn= schema 
changetype: modify 
add: objectclasses 

objectclasses: { cgha-cluster-version — oc-oid 
NAME ' cgha-cluster-version — oc' 
SUP top 

MUST ( cgha-cluster-version ) ) 

Eh7-01 1 (cgha-cluster-update-level-- oc) 

dn: cn=schema 
changetype: modify 
add: attributetypes 

attributetypes: ( cgha-cluster-update-level-oid 
NAME 'cgha-cluster-update-level' 

SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 # Directory String 



1er depot 



109 

SINGLE-VALUE ) 
dn: cn= schema 
changetype: modify 
add: obj ectclasses 

obj ectclasses : ( cgha-cluster-update-level--oc-oid 
NAME ' cgha-cluster-update-level — oc' 
SUP top 

MUST < cgha-cluster-update-level ) ) 

Eh7-012 (cgha-component-type-- oc) 

dn: cn=schema 
changetype: modify 
add: attributetypes 

attributetypes : ( cgha-component-type-oid 
NAME 'cgha-component-type' 

SYNTAX 1.3.6.1.4.1.1-466.115.121.1.15 # Directory String 
SINGLE-VALUE ) 
dn: cn=schema 
changetype: modify 
add: obj ectclasses 

obj ectclasses : ( cgha-component-type--oc-oid 
NAME ' cgha-component-type--oc' 
SUP- top 

MUST ( cgha-component-type ) ) 

Eh7-0 1 3 (component-type-version-oc) 

dn: cn= schema 
changetype: modify 
add: attributetypes 

attributetypes: ( cgha-component-type-version-oid 
NAME ' cgha-component-type-version' 

SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 # Directory String 
SINGLE- VALUE ) 
dn: cn= schema 
changetype: modify 
add: objectclasses 

objectclasses : { cgha-component-type-version — oc-oid 
NAME ' cgha-component-type-version — oc' 
SUP top 

MUST ( cgha-component-type-version ) ) 

Eh7-01 4 (cgha-component-type-update-level-oc) 

dn: cn=schema 
changetype: modify 
add: attributetypes 

attributetypes: ( cgha-component-type-update-level-oid 
NAME ' cgha-component-type-update-level ' 

SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 # Directory String 
SINGLE-VALUE ) 
dn: cn=schema 
changetype: modify 
add: objectclasses 
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objectclasses : ( cgha-component-type-update-level--oc-oid 
NAME ' cgha-component-type-update-level — oc r 
SUP top 

MUST ( cgha-component-type-update-level ) ) 

Eh7-01 5 (cgha-component-instance-name-oc) 

dn : c n= s chema 
changetype: modify 
add: attributetypes 

attributetypes : ( cgha-component-instance-name-oid 
NAME 'cgha-component-instance-name' 

SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 # Directory String 
SINGLE-VALUE " ) 
dn : cn= schema 
changetype: modify 
add: objectclasses 

objectclasses: ( cgha-component-instance-name — oc-oid 
NAME 'cgha-component-instance-name — oc r 
SUP top 

MUST ( cgha-component-instance-name $ 
cgha-component-type } ) 

Eh7-01 6 (cgha-component-instance-update-level— oc) 

dn: cn=schema 
changetype: modify 
add: attributetypes 

attributetypes: ( cgha-component-instance-update-level-oid 

NAME ' cgha-component-instance-update-level' 

SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 # Directory String 

SINGLE-VALUE ) 

dn: cn= schema 

changetype: modify 

add: objectclasses 

objectclasses: ( cgha-component-instance-update-level — oc-oid 
NAME ' cgha-component-instance-update-level — oc' 
SUP top 

MUST ( cgha-component-instance-update-level ) ) 

Eh7-01 7 (cgha-component-assignment-name--oc) 

dn: cn= schema 
changetype: modify 
add: attributetypes 

attributetypes: ( cgha-component-assignment-name-oid 
NAME ' cgha- component -assignment -name' 

SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 # Directory String 
SINGLE- VALUE ) 
dn : cn=schema 
changetype: modify 
add: objectclasses 

objectclasses: ( cgha -component -assignment -name --oc-oid 
NAME ' cgha-component-assignment-name — oc' 



1 er depot 



ill 

SUP top 

MUST ( cgha-component- assignment-name $ 
cgha-component-type ) ) 

Eh7-01 8 (cgha-component-assignment-update-level— oc) 

dn : cn=schema 
Changetype: modify 
add: attributetypes 

attributetypes : ( cgha-component-assignment-update-level-oid 

NAME ' cgha-component-assignment-update-level' 

SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 « Directory String 

SINGLE -VALUE ) 

dn: cn-schema 

changetype: modify 

add: objectciasses 

objectclasses : ( cgha-component-assignment-update-level--oc-oid 
NAME ' cgha-component-assignment-update-Ievel — oc' 
SUP top 

MUST ( cgha-component-assignment-update-level ) ) 

Eh7-0 1 9 (cgha-sap-name-oc) 

dn : .cn-schema 
changetype: modify 
add: attributetypes 

attributetypes: ( cgha-sap-name-oid 
NAME ' cgha- sap -name r 

SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 # Directory String 
SINGLE- VALUE ) 
dn: cn=schema 
changetype: modify 
add: attributetypes 

attributetypes: ( cgha-sap-access-oid 
NAME ' cgha-sap-access' 

SYNTAX 1.3. 6.1.4.1. 1466. 115. 121 .1.15 # Directory String 
SINGLE-VALUE ) 

dn : cn=schema 
changetype: modify 
add: objectclasses 

objectclasses: ( cgha-sap-name — oc-oid 
NAME 'cgha-sap-name — oc' 
SUP top 

MUST { cgha-sap-name $ 
cgha-sap-access ) ) 



Eh7-O20 (cgha-platform-update-version--oc) 

dn: cn=schema 
changetype: modify 
add: attributetypes 

attributetypes : ( cgha-platf orm-update-version-oid 
NAME ' cgha-platform-update-version' 

SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 # Directory String 
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SINGLE- VALUE) 
dn : cn= schema 
changetype: modify 
add: ob jectclasses 

objectclasses : ( cgha-platf orm-update-version — oc-oid 
NAME ' cgha-platf orm-update-version — oc' 
SUP top 

MUST ( cgha-plat form- update -version ) ) 

Eh7-02 1 (cgha-update-level-oc) 

dn: cn= schema 
changetype: modify 
add: attributetypes 

attributetypes : ( cgha-update-level-oid 
NAME ' cgha-update-level' 

SYNTAX 1.3.6.1.4.1.1466.115.121.1.12 # DN 
SINGLE-VALUE ) 
dn: cn= schema 
changetype: modify 
add: attributetypes 

attributetypes: ( cgha-updated-oid 
NAME 'cgha-updated' 

SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 # IA5 String 
SINGLE- VALUE } 
dn: cn= schema 
changetype : modi f y 
add: attributetypes 

attributetypes: { cgha-update-level-dn-oid 
NAME ' cgha-update-level-dn' 

SYNTAX 1.3.6.1.4.1.1466.115.121.1.12 # DN 
SINGLE- VALUE ) 
dn: cn= schema 
changetype: modify 
add: obj ectclasses 

objectclasses : ( cgha-update-level — oc-oid 
NAME 'cgha-update-level — oc' 
SUP top 

MUST ( cgha-update-level 
$ cgha-update-level-dn 
$ cgha-updated ) ) 

EH7-022 (cgha-software-load-version-- oc) 

dn : cn= schema 
changetype: modify 
add: attributetypes 

attributetypes: ( cgha-sof tware-load-version-oid 

NAME 'cgha-software-load-version' 

SYNTAX 1.3.6.1.4.1.14 66.115.121 .1.15 

SINGLE- VALUE ) 

dn : cn= schema 

changetype: modify 

add: attributetypes 
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attributetypes: ( cgha-platf orm-update-dn-oid 
NAME ' cgha-platform-update-dn' . 
SYNTAX 1.3.6.1.4.1.1466.115.121.1.12 # DN 
SINGLE -VALUE ) 
5 dn: cn=schema 

changetype: modify 
add: objectclasses 

objectclasses : { cgha-sof tware-load-version — oc-oid 
NAME ' cgha-sof tware-load-version — oc' 
^ SUP top MUST ( cgha-sof tware-load-version 

$ cgha-platform-update-dn ) ) 
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Exhibit Eh8 - Tables related to LDAP mapping 



Table Eh8-T0 



LDAP Syntax 


LDAP Code 


Definition 


IA5 String 


1.3.6.1.4.1. 1466.115.121. 1.26 


values are case sensitive 


Directory String 


1.3.6.1.4.1.1466.115.121.1.15 


values are not case sensitive 


Distinguished Name 


1.3.6.1.4.1.1466.115.121.1.12 


values are DNs 



Table Eh8-Tl 1 





OMSL Attribute types 


LDAP 


1 


Simple 


LDAP attribute 


2 


Simple (array) 
* array items 


LDAP attribute designating an object class 
* sub-entries instantiating the object class 


3 


Enum 


LDAP attribute designating an object class 
+ instance(s) of that object class 


4 


Structure 


See table Eh8-T12 


Table Eh8-T12 




OMSL 


LDAP 


1 


cgha : interface 
* attributes 


LDAP object class (named along id-mapping rules) 
* see table Eh8-Tll 


2 


cgha : member 

* simple 

* others 


* LDAP attribute 

* see table Eh8-Tl 1 


3 


cgha : structure 
* structure members 


LDAP object class (named along id-mapping rules) 
* see cgha : member 


4 


cgha : objectRef erence 


LDAP object class (named along id-mapping rules) 


5 


cgha : reference 


LDAP object class (named along id-mapping rules) 



a 
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Exhibit Eh9 



Eh9 - A 



<cgha : package nanie="com. sun . cgha . container .bootServer M > 
<cgha: component type= M BootServer" version="l n > 
<cgha : type> 
<cgha :raib> 

<cgha : object name=" component Descriptor" 

type="com.sun . cgha . types . Sof twareComponentDescriptor"> 
<cgha rinit . . . /> 

</cgha : ob ject> 
</cgha:mib> 
</cgha: type> 
< /cgha : component> 
. </cgha : package> 



dn: cgha-object-name-componentDescriptor, 
cgha-component-type-update-level=l, 
cgha-component-type-version=l , 

cgha-component- type=com .sun'. cgha . container . bootServer . BootServe 
ou=types, o=cgha_root 



Eh9 - B 
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Claims 

1. A program product, comprising : 

* groups of data, in a common software language, each group of data comprising : 

- first data modeling components, and interactions between such components, 

- second data modeling a software load, comprising a set of components and a set of 
interactions, as defined in said first data, and 

* first software code capable of interacting with the first and second data, for qualifying said 
second data as defining a valid combination of components. 



2. The program product of claim 1 , wherein the first data comprise separate subsets of data 
for modeling the interactions, and the components. 

3. The program product of claim 1, wherein the first data comprise data modeling software 
components, and data modeling hardware components 

4. The program product of claim 1 , wherein the first software code is capable of interacting 
with the first and second data using first predefined rules. 

5. The program product of claim 4, wherein the first data have version-identifying data for 
the interaction data, and version range identifying data related to component data, and said 
first predefined rules comprise the version of an interaction lying within the version range 
of both components cooperating through that interaction. 

6. The program product of claim 5, wherein: 

* said first data defines directional interactions, each between a server component providing 
an interface, and a client component using that interface, 

* said first data is arranged to attach a "provide " version range identifying value to said 
server component and a "use" version range identifying value to said client component, and 

* said first predefined rules comprise verifying the existence of an interface whose version 
is lying within both version ranges. 

7. The program product of claim 6, wherein: 
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* said first data comprises generic "provide" and "use" entities each having a version range 
identifying attribute, with instances of these "provide" and "use" entities attached to the 
server component and client component with values of the version range identifying 
attribute, respectively, and 

* said first predefined rules comprise: 

- initially verifying that the first data comprise an interaction for each version value in each 
instantiated version range, and 

- for a given pair of a server component and a client component, verifying that the 
intersection of their respective "provide" and "use" version ranges is not nil. 

8. The program product of claim 1 , wherein said group of data comprises generic entities for 
the components, interactions and software load, said generic entities having predefined 
members, and said first and second data using such generic entities for representing the 
components, interactions and software load. 

9. The program product of claim 1, wherein members of the generic entities comprise 
attributes and sub-entities. 

1 0. The program product as claimed in any of claims 1 through 9, wherein said group of data 
is stored in accordance with a common tree structure. 

1 1 . The program product of claim 1 , wherein said group of data fiirther comprises: 

- third data modeling configuration values for loading a software load as defined in the 
second data. 

1 2. The program product of claim 1 1 , further comprising: 

- second software code capable of interacting with the third data for verifying that they 
define a set of required configuration values. 

1 3 . The program product of claim 12, wherein: 

- said group of data comprises generic entities for interactions, with a configuration attribute, 
having a required attribute statement, and 



1er depot 



118 

- said second software code is capable of reverting to the first data for determining the 
required configuration values. 

14. The program product of claim 13, wherein: 

- said group of data also comprises generic entities for components, software load and 
configuration values, said generic entities having a configuration value attribute, and said 
first, second and third data comprise instances of such generic entities for representing the 
components, software load and configuration values, and 

- said second software code is capable of reverting from the third data through the second 
data to the first data, for determining whether a configuration value is present. 

15. The program product of claim 13 or claim 14, wherein: 

- said generic entities comprise a generic entity having a final configuration attribute for at 
least one of the components, interactions, and software load, and 

- said second software code is responsive to finding an attribute value qualified as final, and 
nevertheless finding an attribute value downstream in the sense: interaction, component, 
software load, configuration value, for entering an error processing mode. 

16. The program product of claim 1 1 , wherein said group of data further comprises: 

- fourth data comprising platform update data for designating a configuration update, having 
has an update level, and 

- the program product further comprising third software code capable of determining 
whether a transition to such a configuration update is authorized. 

17. The program product of claim 1 6, wherein the third software code is further capable of 
determining whether a rollback from such a configuration update is authorized. 

1 8. The program product of claim 16, wherein the group of data further comprises a current 
load. 

19. The program product of claim 18, wherein the current load is at least partially 
represented in the form of directory data. 
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20. The program product of claim 16, further comprising fourth software code, capable of 
implementing new configuration values in a platform, based on the group of data. 

21. The program product of claim 16, wherein the fourth data further comprises a new 
software load. 

22. The program product of claim 21, further comprising fifth software code, capable of 
building a software load image implementing the new software load, based on the group of 
data and on package files. 

23. The program product of claim 1, further comprising : 

- sixth software code capable of indicating the state of a component from said group of data, 
in response to a request. 

1 5 24. The program product of claim 23, further comprising : 

- management service code using said sixth software code. 

f 

25. The program product of claim 24, wherein the management service code comprises local ' 
management service code 

20 

26. The program product of claim 24 or 25, wherein the management service code comprises 
a management agent, enabling remote management 

27. The program product as claimed in any of the preceding claims, wherein the group of 
25 data in entirely defined from generic entit ies and from instances of such generic entities, all 

represented in a tree structure, and the tree structure has a system section comprising the 
generic entities, and predefined instances of such generic entities. 



28. The program product as claimed in any of the preceding claims, wherein said first data 
comprise data referred to component instances, and data referred to component assignments. 

29. The program product of claim 1, wherein said common software language is a markup 
language. (~~~^} CABINET NETTER 
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M02x 



AN INTERFACE 
one or more files containing: 
Interfaces, Exceptions, Events, 
Structures, Object references, References 
as they may exist in the platform. 



A COMPONENT 

describes component as it may exist in the platform, 
with: 

* component type configuration (MIB) 

* component instance (MIB and SAP) 

* component assignment (MIB and SAP) 

* cluster configuration (MIB) 
Each may have different versions 



M03x 



<w 4 



A SOFTWARE LOAD 



For each component: 

* configuration type MIB 

* instance MIB 

* assign'ement MIB 

* software packages corresponding to the MIBs 

* descriptor of target localization 

For the host, cluster configuration MIB 
Only one version per software load 



M04x 



M05CLx 



M05x 



A. 



A CONFIGURATION UPDATE 

* corresponds to a software load, and has: 

* configuration load : initialize all MIBs 

* update: modify init values consistently 



A CURRENT LOAD 



H — 



1V 

-1 



A PLATFORM UPDATE 

* List of Configuration updates 

* Current load 

* software load (optional) 
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M02 



1 



Wi = (minVersion, maxVersion) of Ci FOR Ik 
Wj = (minVersion, maxVersion) of Cj FOR Ik 



CHECK WHETHER Wi & Wj = nil 



few 


M03 


List components COMP N 






i 


r 




M02 


BUILD GROUPS (Ci, Cj, Ik) 

OF A CLIENT Ci 

USING INTERFACE Ik, 

AS PROVIDED BY SERVER Ck 



R 6 A% 



M02 


FOR EACH COMPONENT Ci 


i 


r 


M02 

-* 


IUk1 = INTERFACES USED BY Ci 

FOR EACH SUCH INTERFACE 

WUi = (minVersion, maxVersion) FOR USE 


i 


r 


MOI 


FOR EACH j IN WUi V^Rl !X< *T 
INTERFACE MODEL HAS AN INTERFACE lUk 




r 


REPEAT THE SAME WITH 

WPi = (minVersion, maxVersion) FOR PROVIDE 
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CONFIGURATION UPDATE 
Vi = Xi 

( a given version) 




SozO 



1 


r 


M03 


Vi -> COMPONENT Ci 




t 


M02 


Ci -> MIB HAVING Vi , 
MIB -> INTERFACE li 




t 


MOI 


li->TYPE(Vi) 
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List of MIBs (MIBk) 



M03 



GET FILES COMPk <-> MIBk 



M02 

BUILD LIST OF ALL VARIABLES TO BE CONFIGURED 



M05 

CHECK THAT ALL VARIABLES ARE CONFIGURED IN 
THE UPDATE (OR IN THE CURRENT LOAD) 



M04 


Vi = Xi COMPi MiB(COMPi) 




r 


M03 


GET FILE OF COMPi 




f 


M02 


GET FILE HAVING TYPE (Vi) 




f 


M05 


CHECK THAT TYPE(Vi) ::TYPE(Xi) 
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PLATFORM UPDATE 

* CURRENT LOAD 

* (UPDATE) 




COMPARE ALL UPDATE FILES 
WITH CURRENT LOAD FILES 




GENERATE NEW CURRENT 
LOAD FROM PREVIOUS 
CURRENT LOAD AND RESULT OF 
COMPARISON 



GENERATE UPDATED 
CONFIGURATION DATA 
ACCORDINGLY 



ETTER 
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4002 



IMPORT PACKAGE 
DEFINE name, version, description, type 



4004 



DECLARE OBJECT componentDescriptor, 
ITS type, AND OTHER init VALUES 



4006 



INIT ATTRIBUTE componentCategory 




4008 



4010 



INIT ATTRIBUTE creationDescriptor 




4012 



4022 



INIT ATTRIBUTE deploymentDescriptor 
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